@pendle/sdk-boros 1.7.1 → 1.8.1-open-api-migration-v2-20260818044048

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @pendle/sdk-boros
 
+## 1.8.1-open-api-migration-v2-20260818044048
+
+### Patch Changes
+
+- 47ce2b8: feat(sdk): migrate Exchange to the public Open API (/apis)
+
+## 1.8.0
+
+### Minor Changes
+
+- 39fcae2: Aggregator failures now throw a single displayable `AggregatorHelperError` carrying a stable `code`, user-facing `shortMessage`, and structured fields — and it is exported, so consumers can finally catch it.
+
+  - `AggregatorHelperError` — `code`, `shortMessage`, `retryable`, `aggregator`, `requestType`, `requestData`, `status`, `providerMessage`, `providerCode`, `responseData`, plus `.is(err, code?)` and `.isFrom(err, aggregator, requestType?)` narrowing helpers.
+  - `AggregatorErrorCodes` — `AGGREGATOR_TIMEOUT`, `AGGREGATOR_NETWORK_ERROR`, `AGGREGATOR_RATE_LIMITED`, `AGGREGATOR_SERVER_ERROR`, `AGGREGATOR_REQUEST_REJECTED`, `AGGREGATOR_UNKNOWN_ERROR`. Merged into `ErrorCodes`, so `ErrorCodes.AGGREGATOR_TIMEOUT` is the same value.
+  - `defaultAggregatorErrorMessageHandler` — the copy table, keyed by code, exported so a caller can render the default text for a code itself. The copy is fixed for now: there is deliberately no way to install a replacement handler.
+  - `PendleSdkError` is now exported too — it was the base class of every aggregator error and unreachable.
+
+  Nothing was removed from the public surface. `AggregatorHelperRequestError`, `AggregatorHelperServerError`, `UnknownAggregatorHelperError`, `WrappedAxiosError` and `AggregatorHelperAxiosError` are gone, but none of them were exported — a consumer could not name or `instanceof` them, only read their `.message`. That message is the thing this changes.
+
+  A 503 from Bungee used to surface as `BUNGEE: BUNGEE server error, error code unknown` on `.message`, and `BUNGEE: BUNGEE: BUNGEE server error, error code unknown` from `String(err)` and the stack header. The class set `name` to the `AggregatorName`, so `Error.prototype.toString()` (`${name}: ${message}`) stacked the provider on top of a message that already self-prefixed twice. `name` is now the class name, which also stops every aggregator failure collapsing into one `BUNGEE` group in log aggregators. The same error now reads `Bungee is temporarily unavailable. Please try again or pick another route.` on `shortMessage`, with `[AGGREGATOR_SERVER_ERROR aggregator=BUNGEE requestType=quote status=503]` appended on `message` for logs.
+
+  Errors are classified by failure mode rather than by the shape of the underlying axios object, because that is what a caller has to act on — retry, fall back to another route, or fix the request. `classifyAggregatorError` drops its `errorStatuses` and `errorDataCheckingFn` parameters: `classifyAggregatorError(aggregator, error, requestType, requestData)`. Every call site passed the same hardcoded `[500, 502, 503, 504]`, which quietly classified 501/507/599 as unknown, and all 15 passed `() => undefined` as the data checker — which made `AggregatorHelperRequestError` unreachable and threw away every 4xx body the provider sent. A default extractor now reads the provider's own reason off `message`/`error` and its code off `code`/`errorCode`/`statusCode`, the shapes Socket, LI.FI and the Boros API actually return.
+
+  The provider's reason becomes the display copy for `AGGREGATOR_REQUEST_REJECTED` — it is specific and the user can act on it — but is deliberately kept off `shortMessage` for `AGGREGATOR_SERVER_ERROR`, where a 5xx body is an internal detail (`upstream pod OOMKilled` is not for users). It is always available on `providerMessage`. Response bodies live on `responseData` instead of being `JSON.stringify`'d into the message, which previously inlined an unbounded blob into every log line.
+
+  The codes live in `src/errors/AggregatorErrorCodes.ts`, a leaf module with no imports, spread into `ApiErrorCodes`. Handling a swap error should not pull the contract error ABI into the bundle, which is what importing them from `ErrorCodes` would have done.
+
+### Patch Changes
+
+- b09c3c5: Bungee quotes round the slippage they send to 3 decimal places. Socket's backend started rejecting anything longer (`400 Validation Error : slippage must have at most 3 decimal places`), which broke every quote whose slippage came out of the dynamic auto-slippage formulas — `8 / inputValueUsd` on a $999 deposit produces `0.8008006885764801%`.
+
+  Both `quoteDeposit` and `quoteWithdraw` now go through `toBungeeSlippage`, which converts the SDK's decimal (`0.005`) to Socket's percentage (`0.5`) and rounds to nearest 3 dp.
+
+  Rounding is decimal (`toFixed`), not `Math.ceil(x * 1000) / 1000` — the latter bumps 648 of the first 5000 already-valid 3 dp values a full step up on a float ULP, so a caller asking for `0.009%` would have been quoted at `0.01%`.
+
+  A nonzero tolerance that rounds to `0` is floored at `0.001%`, since a zero tolerance makes every route revert. An explicitly requested `0` is passed through unchanged.
+
 ## 1.7.1
 
 ### Patch Changes

package/dist/backend/index.d.ts

@@ -1,2 +1,3 @@
 export * from './secrettune';
+export * from './openApi';
 export * from './LogStore';

package/dist/backend/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./secrettune"), exports);
+__exportStar(require("./openApi"), exports);
 __exportStar(require("./LogStore"), exports);
 //# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,6CAA2B"}