@eco-foundation/api-schemas 0.4.0 → 0.6.0

package/README.md

@@ -4,8 +4,8 @@ Zod-first schemas, error catalog, golden fixtures, and generated OpenAPI 3.1 for
 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**, **37 error codes** (51 namespaced
-legacy references), and **19 golden fixtures**.
+Today the package covers **11 endpoints across 10 paths**, **38 error codes** (51 namespaced
+legacy references), and **17 golden fixtures**.
 
 ## Install
 
@@ -14,13 +14,13 @@ While the package is 0.x, pin the patch range or the exact version:
 ```json
 {
   "dependencies": {
-    "@eco-foundation/api-schemas": "~0.4.0"
+    "@eco-foundation/api-schemas": "~0.6.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.4.0` or the exact `0.4.0`.
+future breaking `0.y` — it is not a pin at all. Use `~0.6.0` or the exact `0.6.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
@@ -30,6 +30,230 @@ A matching version string is not evidence of a matching artifact: also compare
 zod-bearing entry point. Which case you are in is decided entirely by your imports; see
 [Consumers](#consumers).
 
+## Migrating 0.5.0 -> 0.6.0
+
+**BREAKING under 0.x semver** (breaking bumps the minor while the major is 0). Five items REJECT
+a request `0.5.0` accepted or remove something `0.5.0` published; four are additive. Every
+breaking item is listed here — if you send anything named below, read its entry before bumping.
+
+**`V1_SCHEMA_DIGEST` MOVES.** Both digest inputs changed (`errors/catalog.lock.json` gained one
+code; `openapi/v1.json` lost two operations, gained two parameters and several descriptions), so
+the value is now `a6724fa4dd585e77aebe680655ac10fe5a2f4b70537930a0b4dee2612afb7c8e` — was
+`1d8e88e957795b23e1317dc1e3783fd64bf79b756e3f28bd40e02b047542d790` on `0.4.0`, `0.4.1` and
+`0.5.0`. Every consumer running `assertNoSkew` must move to the new value **in the same
+rollout**. Unlike `0.5.0`, this time the skew check DOES see the difference, so a mixed fleet
+fails it by design rather than silently validating two ways.
+
+**THE FIVE BREAKING ITEMS FIRST.**
+
+**1. `slippage` now rejects `0` and anything below `0.0001`, and the rejection is named.**
+
+```ts
+// 0.5.0: parses (and then fails downstream). 0.6.0: 400, code slippage-out-of-bounds, path ['slippage'].
+{ ..., slippage: 0 }
+{ ..., slippage: 0.00005 }
+```
+
+The range is `0.0001`-`1` (`SLIPPAGE_MIN`/`SLIPPAGE_MAX`, both exported), a DECIMAL FRACTION of
+the destination amount: `0.005` is 0.5%. No solver can express a tolerance below one basis
+point, so a `0` could only ever be rejected downstream, silently clamped, or silently replaced
+by a default; refusing it at the edge with a named code is the honest one. Zero tolerance is
+meaningless on a swap route and ignored on a non-swap route, so nothing is lost.
+
+**The code changes for EVERY out-of-range value, not only the new floor.** `0.5.0` enforced the
+bound with a built-in `.min()/.max()`, which zod reports as `too_small`/`too_big` — and
+`v1ErrorCodeFromIssues` maps only a `custom` issue carrying `v1IssueParams`, so the catalog's
+`slippage-out-of-bounds` was promised and unreachable: `50` rendered as the generic
+`invalid-request` with `legacyCode: eco-quotes:1003`. It now renders as
+`slippage-out-of-bounds` (status 400 unchanged, `detail` text unchanged, no `legacyCode`
+because that code has none). An integrator branching on `code === 'invalid-request'` for a
+bad slippage, or reading `legacyCode` there, sees the change. The catalog TITLE names the
+floor now; code, status and `legacyCodes` are untouched.
+
+The published document also carries the units for the first time: both `slippage` fields have a
+`description`, and the request field keeps `minimum`/`maximum` (via `.meta()`, since the bound
+itself lives in a refinement that `z.toJSONSchema` drops). The response `slippage` is documented
+as the tolerance ACTUALLY bound into `destination.minAmountOut` — when a request omits
+`slippage`, that is the default the solver applied, not the omission.
+
+**2. A zero `amount` is rejected on the quote request.**
+
+```ts
+// 0.5.0: parses, reaches a solver, comes back as a 502. 0.6.0: 400, path ['source','amount'].
+{ ..., source: { chainId: 8453, token: '0x…', amount: '0' } }
+```
+
+`source.amount` and `destination.amount` are `PositiveUintString` (new primitive: `UintString`
+with `'0'` excluded, message `must be greater than 0`). Every other `UintString` field is
+unchanged — a zero `value` on a destination call or a zero fee is still legal. The bound reaches
+the OpenAPI document as a `description` only; a string has no `minimum`.
+
+**3. `options.maxCallDataSize` is gone.**
+
+```ts
+// 0.5.0: parses. 0.6.0: 400, unrecognized_keys at path ['options'].
+{ ..., options: { maxCallDataSize: 1000 } }
+```
+
+It was published with no description and read by no service, so a caller sending it was handed
+a 200 for a bound nobody enforced. The strict `options` object now names the key in a 400, the
+same disposition `allowHighSlippage` has had since `0.3.0`. The zod-free `V1QuoteRequest` alias
+drops the member too. A caller that needs a calldata cap needs one that is defined and enforced,
+which is a different change.
+
+**4. `POST /v1/intents/submit/permit2` and `/permit3` are WITHDRAWN.**
+
+Neither lane can complete, and this is why. The signed Permit2 `spender` and every Permit3 leg
+`account` must be the intent VAULT (`Portal.fundFor` pulls the funds through
+`IPermit.transferFrom(funder, vault)`), and the vault is derived from the route salt the router
+dispatches — a value the signer cannot know before signing until quoted-salt dispatch and vault
+binding exist. On top of that the published bodies omitted material the solver requires (permit2
+`chainId`; permit3 `permitContract`, `timestamp`, `merkleRoot`, per-leg `account` /
+`modeOrExpiration`), so the first refusal was a 401 on every request. Advertising a lane whose
+every body ends in a 4xx is a false promise. The lanes return as a follow-on once quoted-salt
+dispatch and vault binding land; `erc-3009` is the quote-target intents standard until then.
+
+What moved, concretely:
+
+- `STANDARDS_BY_TARGET.quote` is `['erc-3009']`. `depositAddress` is unchanged.
+- The two registry entries, the two operations in `openapi/v1.json`, and the two golden fixtures
+  are gone (11 endpoints over 10 paths; 17 fixtures). A router that dispatches from
+  `V1_SUBMIT_SCHEMAS_BY_SERVICE.intents` answers `invalid-parameter` on those routes by
+  construction.
+- **Five exports are deleted:** `Permit3AllowanceSchema`, `Permit3PayloadSchema`,
+  `Permit3SubmitSchema`, `Permit2PermitSingleSchema`, `Permit2SubmitSchema`. No endpoint accepts
+  those bodies, so there is nothing for them to validate.
+- **`V1_SUBMIT_SCHEMAS` is keyed by the new `LaneStandard` type** (`'erc-3009' | 'erc-2612'` —
+  the standards that have a lane), not by `SubmitStandard`. `V1_SUBMIT_SCHEMAS[standard]` with
+  a `SubmitStandard`-typed index no longer compiles; narrow to `LaneStandard` first. That is the
+  intended signal — the alternative was an `undefined` a dispatcher trips over at runtime.
+- **`SUBMIT_STANDARDS` and `SubmitStandard` KEEP all four spellings.** That enum is also the
+  discovery vocabulary a token advertises under `supports`, and narrowing it would make a
+  consumer hard-fail on a token list from a server still spelling `permit3`. The vocabulary is
+  what a token MAY advertise; the matrix is what has a lane. The tokens fixture advertises
+  `quote: ['erc-3009']`.
+
+**5. Consumer-side only, but read it: the lock gained a 502.** `V1ProblemSchema` cross-checks a
+KNOWN code's `status`/`type` against the catalog. `solver-error` (below) is now known, so a body
+carrying that spelling with a contradicting status or type stops parsing where `0.5.0` tolerated
+it as "a newer server". An exhaustive `switch` over `V1ErrorCode` will not compile until it
+handles it.
+
+**THE FOUR ADDITIVE ITEMS.**
+
+**Added — `solver-error` (502): an upstream solver rejected or failed the quote request.**
+`solver-timeout` was the only 502, so a router had to label a solver answering 400 in six
+milliseconds with a title that says "timed out". `solver-error` is the code for every upstream
+failure that is NOT a deadline expiry — a solver 4xx/5xx, a network error, an unparseable body.
+It is 502 rather than 4xx/422 on purpose: the gateway built the RFQ, so a solver rejection is a
+gateway/contract fault, never the caller's, and a 422 mapping would hide a contract bug as "no
+route". `legacyCodes` is EMPTY by construction: `eco-quotes:1025` (Failed) is the ref that would
+belong here, but it was published on `solver-timeout` and the lock is append-only, so it stays
+there. Branch on `code`, not on `status`, to tell the two 502s apart.
+
+**Added — `?chainId=` on `GET /v1/chains` and `GET /v1/tokens`.** OPTIONAL on both (the
+unfiltered document is unchanged and stays legal), a single value only. A malformed value —
+`abc`, `0`, `-1`, `1.5`, or a repeated `?chainId=1&chainId=8453` — is a 400 at the field; a
+syntactically valid chain id that matches nothing is a 200 with `chains: []` /
+`tokens: [], nextCursor: null`, never a 404. New exports: `CHAINS_LIST_QUERY_SHAPE` /
+`ChainsListQuerySchema`, `TOKENS_LIST_QUERY_SHAPE` / `TokensListQuerySchema`, and `ChainIdParam`
+(the coercing query-string twin of the body `ChainId`, which all three `chainId` query params —
+these two and the deposit-address lookup's — now wrap, so the accepted set cannot differ between
+endpoints publishing the same parameter name). Query-side only: never coerce a chain id in a
+JSON body.
+
+**Added — `renderIssuesAsProblemParts(issues, opts?) -> { code, detail?, errors? }`, THE one
+sanctioned path from a `ZodError` to a problem body.** Two services rendered the same validation
+failure with a cap of 4 and a cap of 10, a `(+N more issues)` suffix and an `N issues, first M:`
+prefix, a bare root message and a `(root)` placeholder, and only one of them emitted `errors[]`.
+This function is the single set of conventions: cap `MAX_DETAIL_ISSUES` (8, now exported) for
+both `detail` and `errors`; overflow is ONE trailing `(+N more issues)`; a root-level issue is
+its bare message; `errors` carries bare dotted fields and is omitted when nothing survives.
+Absent keys are absent, so the result spreads straight into `problem(code, rest)` or your own
+builder. `problemFromZodError` is built on it and a test pins that the two produce byte-identical
+bodies. A service with its own problem type should route every `ZodError` through here and
+delete its local cap and overflow constants.
+
+**Added — execution detail on a status entry.** `StatusEntrySchema` and `statusEntrySchemaFor`
+gain three OPTIONAL members: `sourceTx` and `destinationTx` as
+`{ chainId, txHash, token, amount }`, and `steps[]` as
+`{ type: 'SWAP' | 'BRIDGE', status, from, to, transactions: { created?, fulfilled?, refunded? } }`
+with `{ token, amount, chainId }` legs and `{ chainId, txHash }` transaction refs. The shape
+mirrors the solver's step facts verbatim; the step `type` is the producer's vocabulary (not the
+quote-response `StepKind`) and the step `status` is the producer's raw per-step state beneath the
+C1 entry-level vocabulary, deliberately unmapped. **Absent means unknown; `null` is rejected** —
+a null would read as "known to be none" on a lane whose upstream simply has no token/amount.
+Today the quote-status lane can populate them; the general intent-status lane omits them.
+`chainId` is a JSON number (the solver spells it as a string; the producer converts), amounts
+are uint strings, `token` is a bare string because the native asset may be a sentinel. New
+schema exports `StatusTxRefSchema`, `StatusTokenAmountSchema`, `StatusTxDetailSchema`,
+`StatusStepSchema`, `StatusStepType` / `STATUS_STEP_TYPES`; new zod-free aliases `V1StatusTxRef`,
+`V1StatusTokenAmount`, `V1StatusTxDetail`, `V1StatusStep`, `V1StatusStepType`.
+
+## Migrating 0.4.1 -> 0.5.0
+
+**BREAKING under 0.x semver** (breaking bumps the minor while the major is 0): this release
+REJECTS a request body `0.4.1` accepted. Nothing else moved — no code, status, `legacyCodes`
+mapping, or response shape changed.
+
+**`V1_SCHEMA_DIGEST` DOES NOT MOVE, and that is the caveat to read before rolling out.** The new
+rule is a `superRefine`, and `z.toJSONSchema` drops refinements, so neither digest input changed:
+`openapi/v1.json` is byte-identical and `assertNoSkew` cannot see the difference. A fleet running
+`0.4.1` and `0.5.0` side by side therefore passes the skew check while VALIDATING DIFFERENTLY —
+the same body is a 400 on one instance and a 200 on another. Roll every consumer together, or
+accept that inconsistency knowingly.
+
+**Rejected — a `funder` that cannot share a chain with `source.token`.**
+
+```ts
+// 0.4.1: parses. 0.5.0: 400, path ['funder'].
+{ source: { chainId: 1399811149, token: '<a Solana mint>' }, funder: '0x3333…3333' }
+```
+
+Both fields live on the SOURCE chain, so an EVM funder beside a Solana source token describes no
+chain that exists. It used to parse, get quoted, and then fail wherever a service classified the
+funder against the source VM — and a service that read a malformed funder as ITS OWN material
+answered `500 internal-error` for a field the caller sent.
+
+**What this rule deliberately does NOT do: bind `funder` to `source.chainId`.** That needs a
+chain-ID-to-VM table, and this package holds none by design — `ChainId` is any positive integer,
+and `ADDRESS_BY_CHAIN_TYPE` exists for the caller that already knows the chain type. A table here
+would make every published version an allow-list of chains: a newly launched SVM chain would be
+misclassified by every consumer still on an older pin, and its valid base58 funder rejected, so
+this package would have to be re-released and rolled out before a chain could launch. Comparing
+two addresses from the same request needs no table and cannot go stale.
+
+So the check is a NECESSARY condition, not a sufficient one, in two specific ways:
+
+- **Two EVM addresses agree with each other whatever `chainId` says**, including a Solana chain id.
+  A green parse is not evidence the funder is right for the chain.
+- **SVM and TVM are not separated.** A Tron base58check address also satisfies `SvmAddress`'s
+  32-44 character range (see the `AnyAddress` docblock), so shape cannot decide between them and
+  the rule lets that pair through rather than guessing.
+
+A service that knows the chain's VM must still check each address against it. Two new exports help:
+`addressFamilies(value)` returns every family a value is consistent with, and
+`addressFamiliesCanAgree(a, b)` is the pairwise predicate the refinement uses.
+
+## Migrating 0.4.0 -> 0.4.1
+
+Purely additive; no schema, wire, or digest change. `V1_SCHEMA_DIGEST` is UNCHANGED, so this is
+not a coordinated-rollout release — a fleet may run 0.4.0 and 0.4.1 side by side.
+
+**Added — the two conformance skip reasons are exported constants.**
+`SIDE_EFFECT_SKIP_REASON` and `DRAFT_SKIP_REASON` are now named exports of the `./testing`
+subpath. They were previously inline literals in this package's own spec, which meant a consumer
+pinning them had to copy the strings and had no way to notice a rewording — the published tarball
+ships `dist/`, never the sources those literals lived in. Import them instead of copying:
+
+```ts
+import { DRAFT_SKIP_REASON, SIDE_EFFECT_SKIP_REASON } from '@eco-foundation/api-schemas/testing';
+```
+
+This is also the first release cut from `eco/eco-api-schemas`, the package's own repository. It
+previously shipped from a pnpm workspace inside `eco-incorp/router`; nothing about the published
+artifact's contents or layout changed with the move.
+
 ## Migrating 0.3.1 -> 0.4.0
 
 `0.3.1` was never published, so **`0.4.0` is the upgrade from `0.3.0`** and carries `0.3.1`'s
@@ -135,6 +359,13 @@ Tron-source funding quote. Do not read the SVM lane as a precedent that a `tvm`
 behind it: adding one would be a breaking wire change with its own migration note, and nothing
 here commits `/v1` to that surface.
 
+**Added — `./package.json` is an exported subpath.**
+`require('@eco-foundation/api-schemas/package.json')` previously threw
+`ERR_PACKAGE_PATH_NOT_EXPORTED`, which broke tooling that reads a dependency's manifest for
+its version. Nothing else changes; it is purely additive. (`prepack` now also rebuilds
+`dist/` on a manual `npm pack`/`npm publish`, which affects publishing rather than
+consuming.)
+
 **Added — the `errors` problem extension (per-field caller faults).**
 
 ```json
@@ -150,8 +381,13 @@ here commits `/v1` to that surface.
 
 `errors` is **OPTIONAL**: an `invalid-request` for a body that is not JSON at all has no
 field to name, so absence is legal and means exactly that. `field` names the offending
-input in YOUR terms — the path into what you sent (`body.source.chainId`, `query.limit`) —
-and `detail` obeys the same free-text policy as the problem's own `detail`.
+input in YOUR terms — the path into what you sent, with **no `body.`/`query.` prefix**:
+`source.chainId`, `funder`, `limit`. `detail` obeys the same free-text policy as the
+problem's own `detail`.
+
+Because there is no prefix, `field` alone does not say whether the value came from the body
+or the query string. Every /v1 endpoint takes its parameters in exactly one of the two, so
+**key on the route plus `field`**, not on `field` alone.
 
 **`errors` is NOT `solverErrors`.** They sit adjacent and answer different questions:
 `errors` is your own fault (a field you sent, and naming it is how you fix it);
@@ -456,7 +692,7 @@ Zod-major compatibility is the reason there are two interfaces, not one:
 
 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,
+- **`src/fixtures/v1/`** — the 17 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
@@ -519,10 +755,10 @@ which needs no server.
 build → lint:check → test → catalog:check → openapi:check → digest:check
 ```
 
-Both `.github/workflows/ci.yml` (every PR) and `.github/workflows/publish-api-schemas.yml`
+Both `.github/workflows/ci.yml` (every PR) and `.github/workflows/publish.yml`
 (every release tag) run exactly that one command.
 
-**The `verify`-before-`publish` step in the publish workflow is load-bearing — do not
+**The `verify`-before-`stage` step in the release 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
@@ -546,12 +782,37 @@ Two `catalog:check` outcomes are NOT failures and must not be confused with each
 
 ## 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.
+Publishing is **two steps, and CI only does the first one.**
+
+**1. Tag `v<version>`** (must equal `package.json` version). The `Stage release` workflow
+verifies and then runs `npm stage publish`, which uploads the tarball to npm in a pending state.
+It fails with `::error::tag version <x> != package version <y>` if the two drift, so a stale tag
+can never stage a mismatched artifact. It needs the `NPM_TOKEN` repo secret: a granular token
+scoped to `@eco-foundation` with **"Read and write (stage only)"** rights.
+
+**A green run means the version is QUEUED, not released.** Nobody can install it yet.
+
+**2. A maintainer promotes it**, which costs a 2FA challenge:
+
+```
+npm stage list @eco-foundation/api-schemas
+npm stage approve <stage-id>          # or: npm stage reject <stage-id>
+```
+
+The queue is also visible on npmjs.com, and the workflow's run summary repeats these commands.
+
+Why the split: npm removes direct publish from granular access tokens in **January 2027**, and
+an approval cannot be satisfied by any CI credential — token or OIDC — by design. A stolen
+runner token can queue a release; it can never ship one. `npm stage approve` needs npm ≥
+`11.15.0` locally, same as CI.
+
+Two staging rules worth knowing before you tag. The dist-tag is **immutable once staged** — it
+cannot be changed on the way to approval, only rejected and re-staged — and a version that is
+already staged cannot be staged again, so a re-tag of a queued version fails until the queued
+one is approved or rejected.
 
 Semver: breaking schema change = major, additive = minor; consumers pin minor. **While the
-package is 0.x, "pin minor" means `~0.4.0` or the exact `0.4.0` — never `^0`** (see
+package is 0.x, "pin minor" means `~0.6.0` or the exact `0.6.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/fixtures/index.js

@@ -15,8 +15,6 @@ const intents_status_response_intent_filled_json_1 = __importDefault(require("./
 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"));
@@ -29,8 +27,6 @@ const FIXTURE_BINDINGS = [
     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),

package/dist/fixtures/index.js.map

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

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

@@ -14,7 +14,7 @@
                 "symbol": "USDC",
                 "decimals": 6,
                 "supports": {
-                    "quote": ["permit3", "permit2", "erc-3009"],
+                    "quote": ["erc-3009"],
                     "depositAddress": ["erc-2612", "erc-3009"]
                 }
             }

package/dist/generated/build-digest.json

@@ -1,5 +1,5 @@
 {
-    "digest": "1d8e88e957795b23e1317dc1e3783fd64bf79b756e3f28bd40e02b047542d790",
+    "digest": "a6724fa4dd585e77aebe680655ac10fe5a2f4b70537930a0b4dee2612afb7c8e",
     "inputs": [
         "errors/catalog.lock.json",
         "openapi/v1.json"

package/dist/index.d.ts

@@ -3,4 +3,4 @@ export { generateOpenApiDocument, STABLE_TAG } from './openapi';
 export type { V1Fixture } from './testing';
 export { assertMatchesV1Schema, loadV1Fixtures } from './testing';
 export * as v1 from './v1';
-export type { LegacyCodeRef, V1Chain, V1ChainType, V1DepositAddress, V1DepositAddressChainStatus, V1DepositAddressCreateRequest, V1DepositAddressCreateResponse, V1DepositAddressKind, V1DestinationCall, V1ErrorCode, V1ErrorDefinition, V1Execution, V1Fee, V1FeeKind, V1FeeToken, V1FundingTransaction, V1GaslessJob, V1GaslessJobStatus, V1GaslessSubState, V1GaslessSubStatus, V1Guarantee, V1IntentCall, V1IntentReward, V1IntentRoute, V1IntentTokenAmount, V1ProblemBody, V1QuoteCore, V1QuoteRequest, V1QuoteResponse, V1RankedQuoteEntry, V1RelatedIntent, V1RelatedIntentRole, V1SolverIdentity, V1StatusEntry, V1StatusType, V1Step, V1StepKind, V1StepLeg, V1SvmAccountMeta, V1SvmInstruction, V1SwapType, V1TokenEntry, V1Visibility, } from './v1/types';
+export type { LegacyCodeRef, V1Chain, V1ChainType, V1DepositAddress, V1DepositAddressChainStatus, V1DepositAddressCreateRequest, V1DepositAddressCreateResponse, V1DepositAddressKind, V1DestinationCall, V1ErrorCode, V1ErrorDefinition, V1Execution, V1Fee, V1FeeKind, V1FeeToken, V1FundingTransaction, V1GaslessJob, V1GaslessJobStatus, V1GaslessSubState, V1GaslessSubStatus, V1Guarantee, V1IntentCall, V1IntentReward, V1IntentRoute, V1IntentTokenAmount, V1ProblemBody, V1QuoteCore, V1QuoteRequest, V1QuoteResponse, V1RankedQuoteEntry, V1RelatedIntent, V1RelatedIntentRole, V1SolverIdentity, V1StatusEntry, V1StatusStep, V1StatusStepType, V1StatusTokenAmount, V1StatusTxDetail, V1StatusTxRef, V1StatusType, V1Step, V1StepKind, V1StepLeg, V1SvmAccountMeta, V1SvmInstruction, V1SwapType, V1TokenEntry, V1Visibility, } from './v1/types';

package/dist/testing/index.d.ts

@@ -5,3 +5,5 @@ export declare function assertMatchesV1Schema(endpointId: V1EndpointId, payload:
     direction?: 'request' | 'response';
 }): void;
 export declare function loadV1Fixtures(): readonly V1Fixture[];
+export declare const SIDE_EFFECT_SKIP_REASON = "sideEffect fixture \u2014 covered by flow E2Es";
+export declare const DRAFT_SKIP_REASON = "draft endpoint (x-stability: draft) \u2014 not served at launch";

package/dist/testing/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DRAFT_SKIP_REASON = exports.SIDE_EFFECT_SKIP_REASON = void 0;
 exports.assertMatchesV1Schema = assertMatchesV1Schema;
 exports.loadV1Fixtures = loadV1Fixtures;
 const zod_1 = require("zod");
@@ -24,4 +25,6 @@ function assertMatchesV1Schema(endpointId, payload, opts = {}) {
 function loadV1Fixtures() {
     return fixtures_1.V1_FIXTURES;
 }
+exports.SIDE_EFFECT_SKIP_REASON = 'sideEffect fixture — covered by flow E2Es';
+exports.DRAFT_SKIP_REASON = 'draft endpoint (x-stability: draft) — not served at launch';
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";;AA0BA,sDAqBC;AAED,wCAEC;AAnDD,6BAAwB;AAExB,0CAAqD;AACrD,uDAA4F;AAY5F,MAAM,WAAW,GAA+C,uBAAY,CAAC;AAW7E,SAAgB,qBAAqB,CACnC,UAAwB,EACxB,OAAgB,EAChB,OAA+C,EAAE;IAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,CAAC,UAAU,CAAC,iBAAiB,SAAS,KAAK;YAC3E,cAAc,MAAM,CAAC,IAAI,CAAC,uBAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAA0B,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3F,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,SAAS,SAAS,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,0BAA0B,UAAU,IAAI,SAAS,aAAa,OAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,cAAc;IAC5B,OAAO,sBAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";;;AA0BA,sDAqBC;AAED,wCAEC;AAnDD,6BAAwB;AAExB,0CAAqD;AACrD,uDAA4F;AAY5F,MAAM,WAAW,GAA+C,uBAAY,CAAC;AAW7E,SAAgB,qBAAqB,CACnC,UAAwB,EACxB,OAAgB,EAChB,OAA+C,EAAE;IAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,CAAC,UAAU,CAAC,iBAAiB,SAAS,KAAK;YAC3E,cAAc,MAAM,CAAC,IAAI,CAAC,uBAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAA0B,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3F,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,SAAS,SAAS,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,0BAA0B,UAAU,IAAI,SAAS,aAAa,OAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,cAAc;IAC5B,OAAO,sBAAW,CAAC;AACrB,CAAC;AASY,QAAA,uBAAuB,GAAG,2CAA2C,CAAC;AACtE,QAAA,iBAAiB,GAAG,4DAA4D,CAAC"}

package/dist/v1/endpoints/chains.d.ts

@@ -1,4 +1,11 @@
 import { z } from 'zod';
+export declare const CHAINS_LIST_QUERY_SHAPE: {
+    chainId: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+};
+export declare const ChainsListQuerySchema: z.ZodObject<{
+    chainId: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ChainsListQuery = z.infer<typeof ChainsListQuerySchema>;
 export declare const ChainContractsSchema: z.ZodObject<{
     portal: z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>, z.ZodString]>;
     executor: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>, z.ZodString]>>;

package/dist/v1/endpoints/chains.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChainsResponseSchema = exports.V1LimitsSchema = exports.ChainSchema = exports.ChainContractsSchema = void 0;
+exports.ChainsResponseSchema = exports.V1LimitsSchema = exports.ChainSchema = exports.ChainContractsSchema = exports.ChainsListQuerySchema = exports.CHAINS_LIST_QUERY_SHAPE = void 0;
 const zod_1 = require("zod");
 const enums_1 = require("../enums");
 const primitives_1 = require("../primitives");
 const status_1 = require("./status");
+exports.CHAINS_LIST_QUERY_SHAPE = {
+    chainId: primitives_1.ChainIdParam.optional(),
+};
+exports.ChainsListQuerySchema = zod_1.z.object(exports.CHAINS_LIST_QUERY_SHAPE);
 exports.ChainContractsSchema = zod_1.z.looseObject({
     portal: primitives_1.AnyAddress,
     executor: primitives_1.AnyAddress.nullable(),

package/dist/v1/endpoints/chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/v1/endpoints/chains.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,oCAAiE;AACjE,8CAAoD;AACpD,qCAA8C;AAKjC,QAAA,oBAAoB,GAAG,OAAC,CAAC,WAAW,CAAC;IAChD,MAAM,EAAE,uBAAU;IAMlB,QAAQ,EAAE,uBAAU,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG,OAAC,CAAC,WAAW,CAAC;IACvC,OAAO,EAAE,oBAAO;IAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IASvB,WAAW,EAAE,uBAAU;IAEvB,IAAI,EAAE,iBAAS;IACf,QAAQ,EAAE,qBAAa;IAEvB,MAAM,EAAE,mBAAW;IACnB,SAAS,EAAE,4BAAoB;CAChC,CAAC,CAAC;AAwCU,QAAA,cAAc,GAAG,OAAC,CAAC,WAAW,CAAC;IAC1C,MAAM,EAAE,2BAAkB;CAC3B,CAAC,CAAC;AAGU,QAAA,oBAAoB,GAAG,OAAC,CAAC,WAAW,CAAC;IAChD,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,mBAAW,CAAC;IAC5B,MAAM,EAAE,sBAAc,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/v1/endpoints/chains.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,oCAAiE;AACjE,8CAAkE;AAClE,qCAA8C;AAejC,QAAA,uBAAuB,GAAG;IACrC,OAAO,EAAE,yBAAY,CAAC,QAAQ,EAAE;CACjC,CAAC;AAEW,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC,+BAAuB,CAAC,CAAC;AAM1D,QAAA,oBAAoB,GAAG,OAAC,CAAC,WAAW,CAAC;IAChD,MAAM,EAAE,uBAAU;IAMlB,QAAQ,EAAE,uBAAU,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG,OAAC,CAAC,WAAW,CAAC;IACvC,OAAO,EAAE,oBAAO;IAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IASvB,WAAW,EAAE,uBAAU;IAEvB,IAAI,EAAE,iBAAS;IACf,QAAQ,EAAE,qBAAa;IAEvB,MAAM,EAAE,mBAAW;IACnB,SAAS,EAAE,4BAAoB;CAChC,CAAC,CAAC;AAwCU,QAAA,cAAc,GAAG,OAAC,CAAC,WAAW,CAAC;IAC1C,MAAM,EAAE,2BAAkB;CAC3B,CAAC,CAAC;AAGU,QAAA,oBAAoB,GAAG,OAAC,CAAC,WAAW,CAAC;IAChD,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,mBAAW,CAAC;IAC5B,MAAM,EAAE,sBAAc,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}

package/dist/v1/endpoints/deposit-addresses.js

@@ -80,7 +80,7 @@ exports.DEPOSIT_ADDRESS_LOOKUP_QUERY_SHAPE = {
     depositAddress: primitives_1.EvmAddress.optional(),
     depositor: primitives_1.EvmAddress.optional(),
     destinationAddress: primitives_1.AnyAddress.optional(),
-    chainId: zod_1.z.coerce.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+    chainId: primitives_1.ChainIdParam.optional(),
     kind: exports.DepositAddressKind.optional(),
     ...status_1.PagingFields,
 };

package/dist/v1/endpoints/deposit-addresses.js.map

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

package/dist/v1/endpoints/quotes.d.ts

@@ -6,6 +6,8 @@ export declare const DestinationCallSchema: z.ZodObject<{
     tokenOut: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>, z.ZodString]>>;
     gasLimit: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
+export declare const SLIPPAGE_MIN = 0.0001;
+export declare const SLIPPAGE_MAX = 1;
 export declare const QuoteRequestSchema: z.ZodObject<{
     swapType: z.ZodEnum<{
         custom: "custom";
@@ -40,7 +42,6 @@ export declare const QuoteRequestSchema: z.ZodObject<{
             public: "public";
             private: "private";
         }>>;
-        maxCallDataSize: z.ZodOptional<z.ZodNumber>;
         allQuotes: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
 }, z.core.$strict>;

package/dist/v1/endpoints/quotes.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QUOTE_SIGNATURE_TYPES = exports.QuoteResponseSchema = exports.RankedQuoteEntrySchema = exports.QuoteCoreSchema = exports.ExecutionSchema = exports.IntentRewardSchema = exports.IntentRouteSchema = exports.IntentCallSchema = exports.IntentTokenAmountSchema = exports.FundingTransactionSchema = exports.SvmTransactionSchema = exports.SvmInstructionSchema = exports.SvmAccountMetaSchema = exports.EvmTransactionSchema = exports.SolverIdentitySchema = exports.RelatedIntentSchema = exports.StepSchema = exports.StepLegSchema = exports.FeeSchema = exports.FeeTokenSchema = exports.QuoteRequestSchema = exports.DestinationCallSchema = void 0;
+exports.QUOTE_SIGNATURE_TYPES = exports.QuoteResponseSchema = exports.RankedQuoteEntrySchema = exports.QuoteCoreSchema = exports.ExecutionSchema = exports.IntentRewardSchema = exports.IntentRouteSchema = exports.IntentCallSchema = exports.IntentTokenAmountSchema = exports.FundingTransactionSchema = exports.SvmTransactionSchema = exports.SvmInstructionSchema = exports.SvmAccountMetaSchema = exports.EvmTransactionSchema = exports.SolverIdentitySchema = exports.RelatedIntentSchema = exports.StepSchema = exports.StepLegSchema = exports.FeeSchema = exports.FeeTokenSchema = exports.QuoteRequestSchema = exports.SLIPPAGE_MAX = exports.SLIPPAGE_MIN = exports.DestinationCallSchema = void 0;
 exports.quoteSignaturePayload = quoteSignaturePayload;
 const zod_1 = require("zod");
 const enums_1 = require("../enums");
 const catalog_1 = require("../errors/catalog");
+const problem_1 = require("../errors/problem");
 const primitives_1 = require("../primitives");
 exports.DestinationCallSchema = zod_1.z.strictObject({
     target: primitives_1.AnyAddress,
@@ -16,32 +17,48 @@ exports.DestinationCallSchema = zod_1.z.strictObject({
 const QuoteRequestOptionsSchema = zod_1.z.strictObject({
     deadlineSec: zod_1.z.number().int().positive().optional(),
     visibility: enums_1.Visibility.optional(),
-    maxCallDataSize: zod_1.z.number().int().positive().optional(),
     allQuotes: zod_1.z.boolean().optional(),
 });
+exports.SLIPPAGE_MIN = 0.0001;
+exports.SLIPPAGE_MAX = 1;
 const SLIPPAGE_RANGE_MESSAGE = `${(0, catalog_1.getErrorDefinition)('slippage-out-of-bounds').title} (error code: slippage-out-of-bounds)`;
+const SLIPPAGE_DESCRIPTION = 'Decimal fraction of the destination amount: 0.005 = 0.5%. Range 0.0001-1; a percent-style ' +
+    '0.5 would mean 50%.';
 exports.QuoteRequestSchema = zod_1.z
     .strictObject({
     swapType: enums_1.SwapType,
     source: zod_1.z.strictObject({
         chainId: primitives_1.ChainId,
         token: primitives_1.AnyAddress,
-        amount: primitives_1.UintString.optional(),
+        amount: primitives_1.PositiveUintString.optional(),
     }),
     destination: zod_1.z.strictObject({
         chainId: primitives_1.ChainId,
         token: primitives_1.AnyAddress,
-        amount: primitives_1.UintString.optional(),
+        amount: primitives_1.PositiveUintString.optional(),
         recipient: primitives_1.AnyAddress.optional(),
         calls: zod_1.z.array(exports.DestinationCallSchema).optional(),
     }),
     funder: primitives_1.AnyAddress,
     refundRecipient: primitives_1.AnyAddress.optional(),
-    slippage: zod_1.z.number().min(0, SLIPPAGE_RANGE_MESSAGE).max(1, SLIPPAGE_RANGE_MESSAGE).optional(),
+    slippage: zod_1.z
+        .number()
+        .describe(SLIPPAGE_DESCRIPTION)
+        .meta({ minimum: exports.SLIPPAGE_MIN, maximum: exports.SLIPPAGE_MAX })
+        .optional(),
     dappId: primitives_1.DappId.optional(),
     options: QuoteRequestOptionsSchema.optional(),
 })
     .superRefine((req, ctx) => {
+    if (req.slippage !== undefined &&
+        (req.slippage < exports.SLIPPAGE_MIN || req.slippage > exports.SLIPPAGE_MAX)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['slippage'],
+            params: (0, problem_1.v1IssueParams)('slippage-out-of-bounds'),
+            message: SLIPPAGE_RANGE_MESSAGE,
+        });
+    }
     const hasCalls = (req.destination.calls?.length ?? 0) > 0;
     if (req.swapType === 'custom' && !hasCalls) {
         ctx.addIssue({
@@ -80,6 +97,13 @@ exports.QuoteRequestSchema = zod_1.z
             message: `${req.swapType} requires source.amount`,
         });
     }
+    if (!(0, primitives_1.addressFamiliesCanAgree)(req.funder, req.source.token)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['funder'],
+            message: 'funder is not from the same address family as source.token',
+        });
+    }
 });
 exports.FeeTokenSchema = zod_1.z.looseObject({
     chainId: primitives_1.ChainId,
@@ -197,7 +221,10 @@ exports.QuoteCoreSchema = zod_1.z.looseObject({
         symbol: zod_1.z.string().nullable(),
         decimals: zod_1.z.number().int().nullable(),
     }),
-    slippage: zod_1.z.number().min(0),
+    slippage: zod_1.z
+        .number()
+        .min(0)
+        .describe('Tolerance actually bound into destination.minAmountOut, as a decimal fraction'),
     fees: zod_1.z.array(exports.FeeSchema),
     steps: zod_1.z.array(exports.StepSchema),
     relatedIntents: zod_1.z.array(exports.RelatedIntentSchema),