@eco-foundation/api-schemas 0.1.0

package/README.md

@@ -0,0 +1,160 @@
+# @eco-foundation/api-schemas
+
+Zod-first schemas, error catalog, golden fixtures, and generated OpenAPI 3.1 for the Eco `/v1`
+API. The Zod schemas are the source of truth; everything else (OpenAPI, fixtures, plain types)
+is generated from or gated against them.
+
+Today the package covers **13 endpoints across 12 paths**, **33 error codes** (51 namespaced
+legacy references), and **19 golden fixtures**.
+
+## Install
+
+While the package is 0.x, pin the patch range or the exact version:
+
+```json
+{
+  "dependencies": {
+    "@eco-foundation/api-schemas": "~0.1.0"
+  }
+}
+```
+
+**Never write `^0`.** npm resolves `^0.x` as `>=0.0.0 <1.0.0`, so it silently accepts every
+future breaking `0.y` — it is not a pin at all. Use `~0.1.0` or the exact `0.1.0`.
+
+A matching version string is not evidence of a matching artifact: also compare
+`V1_SCHEMA_DIGEST` (see [Invariants](#invariants-enforced-in-ci)). Two builds both called
+`0.1.0` — a registry copy and a `file:` tarball, say — can carry different schemas.
+
+## Consumers
+
+| Consumer                             | Import                                                                                   | Zod requirement                        |
+| ------------------------------------ | ---------------------------------------------------------------------------------------- | -------------------------------------- |
+| eco-router (serves /v1)              | `import { v1 } from '@eco-foundation/api-schemas'`                                       | none extra — zod ships as a dependency |
+| deposit-addresses (native endpoints) | same, plus `assertMatchesV1Schema` from `./testing` in CI                                | none extra                             |
+| solver-v2 (Zod 3 — must not upgrade) | `import type { V1QuoteResponse } from '@eco-foundation/api-schemas/v1/types'` + fixtures | ZERO zod at runtime and in the `.d.ts` |
+
+Zod-major compatibility is the reason there are two interfaces, not one:
+
+- **Zod-4 consumers** (eco-router `^4.4.3`, deposit-addresses `^4.3.5`) import the schemas
+  directly. `zod` is a regular dependency of this package pinned **exact `4.4.3`** — nobody has
+  to install Zod 4 themselves, and the exact pin is what keeps the generated OpenAPI byte-stable
+  across zod patches. pnpm dedupes it against a consumer's own Zod 4.
+- **solver-v2 is on Zod 3 and must never be forced to Zod 4.** It consumes the zod-free
+  `./v1/types` subpath (plain `type` aliases, no zod in the emitted `.d.ts`) plus the golden
+  fixtures. Root-level type re-exports from the bare package name exist as a convenience for
+  Zod-4 consumers, but their `.d.ts` reaches zod through the `v1` namespace — solver-v2 must use
+  the subpath.
+- `viem` is a **dev-only** dependency (the reference implementation the signature and
+  quote-signature vector suites check against). It stays out of `dependencies`, so a consumer
+  install pulls only `zod` and `@noble/hashes`.
+
+## Import surface
+
+| Subpath                                    | Contents                                                                                                                       |
+| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
+| `.`                                        | `v1` namespace, `V1_SCHEMA_DIGEST`, `assertMatchesV1Schema`, `loadV1Fixtures`, `generateOpenApiDocument`, root type re-exports |
+| `./v1/types`                               | zod-free `type` aliases (the solver-v2 interface)                                                                              |
+| `./testing`                                | `assertMatchesV1Schema`, `loadV1Fixtures`, `V1Fixture`                                                                         |
+| `./openapi/v1.json`                        | the generated OpenAPI 3.1 document                                                                                             |
+| `./fixtures/signature-hash/vectors.json`   | cross-repo `signatureHash` vectors                                                                                             |
+| `./fixtures/quote-signature/vector-*.json` | cross-repo F3 quote-signature (EIP-712) vectors                                                                                |
+
+## Fixtures
+
+There are two fixture locations and they serve different jobs — do not conflate them:
+
+- **`src/fixtures/v1/`** — the 19 golden request/response payloads, one per endpoint variant,
+  consumed through **`loadV1Fixtures()`** rather than by file path. Each entry carries its
+  endpoint id, direction, variant, and the C12 replay metadata (`method`, `path`,
+  `expectedStatus`, `sideEffect`, optional `stability` and `headers`), so a live-replay harness
+  drives itself from the array. They are TypeScript-imported, so `tsc` emits them into `dist/`
+  and they ship compiled — no copy step.
+- **Package-root `fixtures/`** — the shared cross-repo vectors, shipped raw and read by
+  subpath, because all four repos assert against the same bytes:
+  `fixtures/signature-hash/vectors.json` (the `signatureHash` canonicalization contract) and
+  `fixtures/quote-signature/vector-*.json` (the F3 EIP-712 `EcoQuoteV1` vectors, each with its
+  `digest`, `signature`, and `signer`; the signing key is derived from a public domain string,
+  so this repo ships no private-key bytes).
+
+`routes.list` is the one fixture tagged `stability: 'draft'`. A live-replay consumer skips it
+with the reason `draft endpoint (x-stability: draft) — not served at launch` instead of
+demanding a 200 from an endpoint no service serves at launch, which makes the read-safe replay
+set **7 of the 8 GET fixtures**. Schema conformance still covers it in this package's own suite,
+which needs no server.
+
+## Invariants (enforced in CI)
+
+- Error catalog is append-only: `errors/catalog.lock.json` diffed against `origin/main`
+  (`pnpm run catalog:check`). Codes are explicit literals; `legacyCodes` are namespaced
+  (`eco-quotes:` / `deposit-addresses:` collide numerically by construction).
+- `openapi/v1.json` is regenerated and diffed (`pnpm run openapi:check`).
+- Every fixture in `src/fixtures/v1` parses through its endpoint schema, and its replay metadata
+  matches the registry entry (`method`, `expectedStatus`, `sideEffect`, `stability`).
+- `v1/types` stays mutually assignable with the schemas (compile-time gate) and zod-free at
+  runtime.
+- Wire schemas are transform-free; requests strip unknown keys, responses are loose
+  (`z.looseObject`). Tolerant enum helpers exist for consumers only.
+- `signatureHash` = keccak256 of the canonical signature encoding (low-s, v ∈ {27,28}, 65-byte
+  expanded). Consumers MUST enforce uniqueness in the store (unique index / atomic upsert) —
+  never check-then-act.
+- `fixtures/signature-hash/vectors.json` is the cross-repo `signatureHash` contract: eco-router
+  and deposit-addresses import the util and assert these vectors; solver-v2 keeps a local copy
+  of the util ONLY with this file copied into its fixtures and asserted byte-for-byte.
+- `fixtures/quote-signature/vector-*.json` are the F3 quote-signature golden vectors (EIP-712
+  `EcoQuoteV1` domain); eco-router's signing path must reproduce every `digest`/`signature`.
+- `V1_SCHEMA_DIGEST` is sha256 over `errors/catalog.lock.json` then `openapi/v1.json`,
+  byte-exact and in that order, regenerated and diffed (`pnpm run digest:check`). It is the
+  cross-consumer skew identity: every service serving or validating `/v1` must report the same
+  digest.
+- Status vocabularies are the single source (canon C1) — every service maps its internal states
+  INTO them; the `intentHashes: Bytes32[]` handoff field is plural bare hashes everywhere.
+- A quote response's `quotes` field is ALWAYS present (P8): `null` unless the request set
+  `options.allQuotes`, otherwise the ranked list (best-priced first) whose entry 0 IS the
+  envelope's quote. Entries are the same core quote object, each independently executable and
+  separately signed.
+
+## Gates
+
+`pnpm run verify` is the whole gate and runs all six steps in order:
+
+```
+build → lint:check → test → catalog:check → openapi:check → digest:check
+```
+
+Both `.github/workflows/ci.yml` (every PR) and `.github/workflows/publish-api-schemas.yml`
+(every release tag) run exactly that one command.
+
+**The `verify`-before-`publish` step in the publish workflow is load-bearing — do not
+streamline it away.** `build` uses `tsconfig.build.json`, which excludes `src/**/*.spec.ts`, so
+the compile-time gates that live in spec files — most importantly the `v1/types` parity gate —
+cannot fail `build`. They fail `test`. Publishing without running `verify` would therefore ship
+a `./v1/types` alias that has silently drifted from its schema.
+
+What each gate says when it trips:
+
+| Gate            | Failure output                                                                                                        | Fix                                                       |
+| --------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| types parity    | `error TS2344: Type '"V1QuoteRequest"' does not satisfy the constraint 'never'` — the message NAMES the drifted alias | update the alias in `src/v1/types.ts` to match the schema |
+| `openapi:check` | `openapi/v1.json is stale — run: pnpm run openapi:generate`                                                           | `pnpm run openapi:generate` (byte-stable across runs)     |
+| `digest:check`  | `src/generated/build-digest.json is stale — run: pnpm run digest:generate`                                            | `pnpm run digest:generate`                                |
+| `catalog:check` | a per-violation list naming the removed or mutated code                                                               | append instead of mutating; `pnpm run catalog:lock`       |
+
+Two `catalog:check` outcomes are NOT failures and must not be confused with each other:
+
+- `no baseline lock at origin/main:… — append-only check skipped (first introduction)` is
+  correct while the lock has never been on `main`. The gate starts enforcing the moment it is.
+- An **unresolvable** `origin/main` FAILS instead, naming `fetch-depth: 0` — a shallow clone
+  must never silently turn the append-only gate into a permanent no-op.
+
+## Publishing
+
+Tag `api-schemas-v<version>` (must equal `package.json` version) — the `publish-api-schemas`
+workflow verifies and publishes. It fails with `::error::tag version <x> != package version <y>`
+if the two drift, so a stale tag can never publish a mismatched artifact.
+
+Semver: breaking schema change = major, additive = minor; consumers pin minor. **While the
+package is 0.x, "pin minor" means `~0.1.0` or the exact `0.1.0` — never `^0`** (see
+[Install](#install)). Consumers additionally compare `V1_SCHEMA_DIGEST`: a matching version
+string is not evidence of a matching artifact. `/v1/routes` is draft-tagged and exempt until its
+stability flips.

package/dist/build-digest.d.ts

@@ -0,0 +1,2 @@
+export declare const V1_SCHEMA_DIGEST: string;
+export declare const V1_SCHEMA_DIGEST_INPUTS: readonly string[];

package/dist/build-digest.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1_SCHEMA_DIGEST_INPUTS = exports.V1_SCHEMA_DIGEST = void 0;
+const build_digest_json_1 = __importDefault(require("./generated/build-digest.json"));
+exports.V1_SCHEMA_DIGEST = build_digest_json_1.default.digest;
+exports.V1_SCHEMA_DIGEST_INPUTS = build_digest_json_1.default.inputs;
+//# sourceMappingURL=build-digest.js.map

package/dist/build-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-digest.js","sourceRoot":"","sources":["../src/build-digest.ts"],"names":[],"mappings":";;;;;;AAAA,sFAAsD;AASzC,QAAA,gBAAgB,GAAW,2BAAS,CAAC,MAAM,CAAC;AAC5C,QAAA,uBAAuB,GAAsB,2BAAS,CAAC,MAAM,CAAC"}

package/dist/fixtures/index.d.ts

@@ -0,0 +1,14 @@
+import type { V1EndpointId } from '../v1/endpoints/registry';
+export interface V1Fixture {
+    endpointId: V1EndpointId;
+    direction: 'request' | 'response';
+    variant: string;
+    method: 'GET' | 'POST';
+    path: string;
+    expectedStatus: number;
+    sideEffect: boolean;
+    stability?: 'stable' | 'draft';
+    headers?: Record<string, string>;
+    payload: unknown;
+}
+export declare const V1_FIXTURES: readonly V1Fixture[];

package/dist/fixtures/index.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1_FIXTURES = void 0;
+const chains_list_response_default_json_1 = __importDefault(require("./v1/chains-list.response.default.json"));
+const deposit_addresses_create_request_gateway_erc20_json_1 = __importDefault(require("./v1/deposit-addresses-create.request.gateway-erc20.json"));
+const deposit_addresses_create_response_gateway_erc20_json_1 = __importDefault(require("./v1/deposit-addresses-create.response.gateway-erc20.json"));
+const deposit_addresses_lookup_response_default_json_1 = __importDefault(require("./v1/deposit-addresses-lookup.response.default.json"));
+const deposit_addresses_submit_erc_2612_request_deposit_address_target_json_1 = __importDefault(require("./v1/deposit-addresses-submit-erc-2612.request.deposit-address-target.json"));
+const deposit_addresses_submit_erc_3009_request_deposit_address_target_json_1 = __importDefault(require("./v1/deposit-addresses-submit-erc-3009.request.deposit-address-target.json"));
+const intents_status_response_gasless_handoff_json_1 = __importDefault(require("./v1/intents-status.response.gasless-handoff.json"));
+const intents_status_response_intent_filled_json_1 = __importDefault(require("./v1/intents-status.response.intent-filled.json"));
+const intents_status_response_unknown_json_1 = __importDefault(require("./v1/intents-status.response.unknown.json"));
+const intents_status_response_wallet_page_json_1 = __importDefault(require("./v1/intents-status.response.wallet-page.json"));
+const intents_submit_erc_3009_response_job_json_1 = __importDefault(require("./v1/intents-submit-erc-3009.response.job.json"));
+const intents_submit_permit2_request_quote_target_json_1 = __importDefault(require("./v1/intents-submit-permit2.request.quote-target.json"));
+const intents_submit_permit3_request_quote_target_json_1 = __importDefault(require("./v1/intents-submit-permit3.request.quote-target.json"));
+const quotes_create_request_public_swap_json_1 = __importDefault(require("./v1/quotes-create.request.public-swap.json"));
+const quotes_create_response_all_quotes_json_1 = __importDefault(require("./v1/quotes-create.response.all-quotes.json"));
+const quotes_create_response_private_swap_json_1 = __importDefault(require("./v1/quotes-create.response.private-swap.json"));
+const quotes_create_response_public_swap_json_1 = __importDefault(require("./v1/quotes-create.response.public-swap.json"));
+const routes_list_response_default_json_1 = __importDefault(require("./v1/routes-list.response.default.json"));
+const tokens_list_response_default_json_1 = __importDefault(require("./v1/tokens-list.response.default.json"));
+const bind = (endpointId, direction, variant, json, meta = {}) => ({ endpointId, direction, variant, json, ...meta });
+const FIXTURE_BINDINGS = [
+    bind('quotes.create', 'request', 'public-swap', quotes_create_request_public_swap_json_1.default),
+    bind('quotes.create', 'response', 'public-swap', quotes_create_response_public_swap_json_1.default),
+    bind('quotes.create', 'response', 'private-swap', quotes_create_response_private_swap_json_1.default),
+    bind('quotes.create', 'response', 'all-quotes', quotes_create_response_all_quotes_json_1.default),
+    bind('intents.submit.permit3', 'request', 'quote-target', intents_submit_permit3_request_quote_target_json_1.default),
+    bind('intents.submit.permit2', 'request', 'quote-target', intents_submit_permit2_request_quote_target_json_1.default),
+    bind('intents.submit.erc-3009', 'response', 'job', intents_submit_erc_3009_response_job_json_1.default),
+    bind('deposit-addresses.submit.erc-3009', 'request', 'deposit-address-target', deposit_addresses_submit_erc_3009_request_deposit_address_target_json_1.default),
+    bind('deposit-addresses.submit.erc-2612', 'request', 'deposit-address-target', deposit_addresses_submit_erc_2612_request_deposit_address_target_json_1.default),
+    bind('intents.status', 'response', 'intent-filled', intents_status_response_intent_filled_json_1.default),
+    bind('intents.status', 'response', 'unknown', intents_status_response_unknown_json_1.default),
+    bind('intents.status', 'response', 'gasless-handoff', intents_status_response_gasless_handoff_json_1.default),
+    bind('intents.status', 'response', 'wallet-page', intents_status_response_wallet_page_json_1.default),
+    bind('chains.list', 'response', 'default', chains_list_response_default_json_1.default),
+    bind('tokens.list', 'response', 'default', tokens_list_response_default_json_1.default),
+    bind('routes.list', 'response', 'default', routes_list_response_default_json_1.default, { stability: 'draft' }),
+    bind('deposit-addresses.create', 'request', 'gateway-erc20', deposit_addresses_create_request_gateway_erc20_json_1.default),
+    bind('deposit-addresses.create', 'response', 'gateway-erc20', deposit_addresses_create_response_gateway_erc20_json_1.default),
+    bind('deposit-addresses.lookup', 'response', 'default', deposit_addresses_lookup_response_default_json_1.default),
+];
+function bindFixture(binding) {
+    const file = binding.json;
+    if (file.endpointId !== binding.endpointId ||
+        file.direction !== binding.direction ||
+        file.variant !== binding.variant) {
+        throw new Error(`fixture envelope disagrees with its binding: expected ` +
+            `${binding.endpointId}:${binding.direction}:${binding.variant}, file says ` +
+            `${String(file.endpointId)}:${String(file.direction)}:${String(file.variant)}`);
+    }
+    const declaredStability = binding.stability ?? 'stable';
+    const fileStability = file.stability ?? 'stable';
+    if (fileStability !== declaredStability) {
+        throw new Error(`fixture stability disagrees with its binding for ` +
+            `${binding.endpointId}:${binding.direction}:${binding.variant}: binding says ` +
+            `${declaredStability}, file says ${fileStability}`);
+    }
+    if (JSON.stringify(file.headers ?? {}) !== JSON.stringify(binding.headers ?? {})) {
+        throw new Error(`fixture headers disagree with their binding for ` +
+            `${binding.endpointId}:${binding.direction}:${binding.variant}`);
+    }
+    return file;
+}
+exports.V1_FIXTURES = FIXTURE_BINDINGS.map(bindFixture);
+//# sourceMappingURL=index.js.map

package/dist/fixtures/index.js.map

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

package/dist/fixtures/v1/chains-list.response.default.json

@@ -0,0 +1,37 @@
+{
+    "endpointId": "chains.list",
+    "direction": "response",
+    "variant": "default",
+    "method": "GET",
+    "path": "/v1/chains",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "chains": [
+            {
+                "chainId": 728126428,
+                "name": "Tron",
+                "type": "tvm",
+                "encoding": "abi",
+                "status": "live",
+                "quoteSigner": "0x1111111111111111111111111111111111111111",
+                "contracts": {
+                    "portal": "TJRabPrwbZy45sbavfcjinPJC18kjpRTv8",
+                    "executor": null
+                }
+            },
+            {
+                "chainId": 8453,
+                "name": "Base",
+                "type": "evm",
+                "encoding": "abi",
+                "status": "live",
+                "quoteSigner": "0x1111111111111111111111111111111111111111",
+                "contracts": {
+                    "portal": "0x2222222222222222222222222222222222222222",
+                    "executor": "0x3333333333333333333333333333333333333333"
+                }
+            }
+        ]
+    }
+}

package/dist/fixtures/v1/deposit-addresses-create.request.gateway-erc20.json

@@ -0,0 +1,16 @@
+{
+    "endpointId": "deposit-addresses.create",
+    "direction": "request",
+    "variant": "gateway-erc20",
+    "method": "POST",
+    "path": "/v1/deposit-addresses",
+    "expectedStatus": 201,
+    "sideEffect": true,
+    "payload": {
+        "chainId": 8453,
+        "depositor": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
+        "kind": "gateway-erc20",
+        "destinationAddress": "0x1111111111111111111111111111111111111111",
+        "destinationChainId": 137
+    }
+}

package/dist/fixtures/v1/deposit-addresses-create.response.gateway-erc20.json

@@ -0,0 +1,20 @@
+{
+    "endpointId": "deposit-addresses.create",
+    "direction": "response",
+    "variant": "gateway-erc20",
+    "method": "POST",
+    "path": "/v1/deposit-addresses",
+    "expectedStatus": 201,
+    "sideEffect": true,
+    "payload": {
+        "id": "deposit-address:0x4444444444444444444444444444444444444444",
+        "depositAddress": "0x4444444444444444444444444444444444444444",
+        "chainId": 8453,
+        "depositor": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
+        "kind": "gateway-erc20",
+        "destinationAddress": "0x1111111111111111111111111111111111111111",
+        "destinationChainId": 137,
+        "expiresAt": null,
+        "createdAt": 1767225000
+    }
+}

package/dist/fixtures/v1/deposit-addresses-lookup.response.default.json

@@ -0,0 +1,24 @@
+{
+    "endpointId": "deposit-addresses.lookup",
+    "direction": "response",
+    "variant": "default",
+    "method": "GET",
+    "path": "/v1/deposit-addresses?depositAddress=0x4444444444444444444444444444444444444444",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "results": [
+            {
+                "id": "deposit-address:0x4444444444444444444444444444444444444444",
+                "depositAddress": "0x4444444444444444444444444444444444444444",
+                "chainId": 8453,
+                "depositor": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
+                "kind": "gateway-erc20",
+                "destinationAddress": "0x1111111111111111111111111111111111111111",
+                "destinationChainId": 137,
+                "expiresAt": null,
+                "createdAt": 1767225000
+            }
+        ]
+    }
+}

package/dist/fixtures/v1/deposit-addresses-submit-erc-2612.request.deposit-address-target.json

@@ -0,0 +1,23 @@
+{
+    "endpointId": "deposit-addresses.submit.erc-2612",
+    "direction": "request",
+    "variant": "deposit-address-target",
+    "method": "POST",
+    "path": "/v1/deposit-addresses/submit/erc-2612",
+    "expectedStatus": 202,
+    "sideEffect": true,
+    "payload": {
+        "chainId": 8453,
+        "target": {
+            "depositAddress": "0x4444444444444444444444444444444444444444"
+        },
+        "permit": {
+            "owner": "0x1111111111111111111111111111111111111111",
+            "spender": "0x4444444444444444444444444444444444444444",
+            "value": "1000000",
+            "nonce": "0",
+            "deadline": 1767225600
+        },
+        "signature": "0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"
+    }
+}

package/dist/fixtures/v1/deposit-addresses-submit-erc-3009.request.deposit-address-target.json

@@ -0,0 +1,24 @@
+{
+    "endpointId": "deposit-addresses.submit.erc-3009",
+    "direction": "request",
+    "variant": "deposit-address-target",
+    "method": "POST",
+    "path": "/v1/deposit-addresses/submit/erc-3009",
+    "expectedStatus": 202,
+    "sideEffect": true,
+    "payload": {
+        "chainId": 8453,
+        "target": {
+            "depositAddress": "0x4444444444444444444444444444444444444444"
+        },
+        "authorization": {
+            "from": "0x1111111111111111111111111111111111111111",
+            "to": "0x4444444444444444444444444444444444444444",
+            "value": "1000000",
+            "validAfter": "0",
+            "validBefore": "1767225600",
+            "nonce": "0xabababababababababababababababababababababababababababababababab"
+        },
+        "signature": "0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"
+    }
+}

package/dist/fixtures/v1/intents-status.response.gasless-handoff.json

@@ -0,0 +1,30 @@
+{
+    "endpointId": "intents.status",
+    "direction": "response",
+    "variant": "gasless-handoff",
+    "method": "GET",
+    "path": "/v1/intents/status?jobId=0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "results": [
+            {
+                "id": "gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
+                "type": "gasless",
+                "status": "published",
+                "updatedAt": 1767225600,
+                "intentHashes": ["0xabababababababababababababababababababababababababababababababab"],
+                "subStatuses": [
+                    {
+                        "chainId": 8453,
+                        "quoteIds": ["quote:8f14e45f-ea3c-4c2d-9b6e-1a2b3c4d5e6f"],
+                        "txHash": "0xefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefef",
+                        "intentHashes": ["0xabababababababababababababababababababababababababababababababab"],
+                        "state": "published"
+                    }
+                ]
+            }
+        ],
+        "nextCursor": null
+    }
+}

package/dist/fixtures/v1/intents-status.response.intent-filled.json

@@ -0,0 +1,21 @@
+{
+    "endpointId": "intents.status",
+    "direction": "response",
+    "variant": "intent-filled",
+    "method": "GET",
+    "path": "/v1/intents/status?intentHash=0xabababababababababababababababababababababababababababababababab",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "results": [
+            {
+                "id": "intent:0xabababababababababababababababababababababababababababababababab",
+                "type": "intent",
+                "status": "filled",
+                "updatedAt": 1767225600,
+                "txHash": "0xefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefef"
+            }
+        ],
+        "nextCursor": null
+    }
+}

package/dist/fixtures/v1/intents-status.response.unknown.json

@@ -0,0 +1,20 @@
+{
+    "endpointId": "intents.status",
+    "direction": "response",
+    "variant": "unknown",
+    "method": "GET",
+    "path": "/v1/intents/status?intentHash=0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "results": [
+            {
+                "id": "intent:0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+                "type": "intent",
+                "status": "unknown",
+                "updatedAt": null
+            }
+        ],
+        "nextCursor": null
+    }
+}

package/dist/fixtures/v1/intents-status.response.wallet-page.json

@@ -0,0 +1,27 @@
+{
+    "endpointId": "intents.status",
+    "direction": "response",
+    "variant": "wallet-page",
+    "method": "GET",
+    "path": "/v1/intents/status?wallet=0x1111111111111111111111111111111111111111&limit=2",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "results": [
+            {
+                "id": "intent:0xabababababababababababababababababababababababababababababababab",
+                "type": "intent",
+                "status": "filled",
+                "updatedAt": 1767225600,
+                "txHash": "0xefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefef"
+            },
+            {
+                "id": "intent:0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+                "type": "intent",
+                "status": "unknown",
+                "updatedAt": null
+            }
+        ],
+        "nextCursor": "Y3Vyc29yOjE3NjcyMjU2MDA6aW50ZW50OjB4YWJhYg"
+    }
+}

package/dist/fixtures/v1/intents-submit-erc-3009.response.job.json

@@ -0,0 +1,25 @@
+{
+    "endpointId": "intents.submit.erc-3009",
+    "direction": "response",
+    "variant": "job",
+    "method": "POST",
+    "path": "/v1/intents/submit/erc-3009",
+    "expectedStatus": 202,
+    "sideEffect": true,
+    "payload": {
+        "id": "gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
+        "status": "processing",
+        "signatureHash": "0xabababababababababababababababababababababababababababababababab",
+        "subStatuses": [
+            {
+                "chainId": 8453,
+                "quoteIds": ["quote:8f14e45f-ea3c-4c2d-9b6e-1a2b3c4d5e6f"],
+                "txHash": null,
+                "intentHashes": [],
+                "state": "pending"
+            }
+        ],
+        "createdAt": 1767225000,
+        "updatedAt": 1767225010
+    }
+}

package/dist/fixtures/v1/intents-submit-permit2.request.quote-target.json

@@ -0,0 +1,25 @@
+{
+    "endpointId": "intents.submit.permit2",
+    "direction": "request",
+    "variant": "quote-target",
+    "method": "POST",
+    "path": "/v1/intents/submit/permit2",
+    "expectedStatus": 202,
+    "sideEffect": true,
+    "payload": {
+        "target": {
+            "quoteId": "quote:8f14e45f-ea3c-4c2d-9b6e-1a2b3c4d5e6f"
+        },
+        "permit2": {
+            "details": {
+                "token": "0x2222222222222222222222222222222222222222",
+                "amount": "1043221",
+                "expiration": 1767225600,
+                "nonce": 0
+            },
+            "spender": "0x1111111111111111111111111111111111111111",
+            "sigDeadline": 1767225600
+        },
+        "signature": "0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"
+    }
+}

package/dist/fixtures/v1/intents-submit-permit3.request.quote-target.json

@@ -0,0 +1,27 @@
+{
+    "endpointId": "intents.submit.permit3",
+    "direction": "request",
+    "variant": "quote-target",
+    "method": "POST",
+    "path": "/v1/intents/submit/permit3",
+    "expectedStatus": 202,
+    "sideEffect": true,
+    "payload": {
+        "target": {
+            "quoteId": "quote:8f14e45f-ea3c-4c2d-9b6e-1a2b3c4d5e6f"
+        },
+        "permit3": {
+            "owner": "0x1111111111111111111111111111111111111111",
+            "salt": "0xabababababababababababababababababababababababababababababababab",
+            "deadline": 1767225600,
+            "permits": [
+                {
+                    "chainId": 8453,
+                    "token": "0x2222222222222222222222222222222222222222",
+                    "amount": "1043221"
+                }
+            ]
+        },
+        "signature": "0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"
+    }
+}

package/dist/fixtures/v1/quotes-create.request.public-swap.json

@@ -0,0 +1,25 @@
+{
+    "endpointId": "quotes.create",
+    "direction": "request",
+    "variant": "public-swap",
+    "method": "POST",
+    "path": "/v1/quotes",
+    "expectedStatus": 200,
+    "sideEffect": true,
+    "payload": {
+        "swapType": "exact-in",
+        "source": {
+            "chainId": 8453,
+            "token": "0x1111111111111111111111111111111111111111",
+            "amount": "1043221"
+        },
+        "destination": {
+            "chainId": 10,
+            "token": "0x2222222222222222222222222222222222222222",
+            "recipient": "0x3333333333333333333333333333333333333333"
+        },
+        "funder": "0x3333333333333333333333333333333333333333",
+        "slippage": 0.005,
+        "dappId": "example-dapp"
+    }
+}