@rabby-wallet/rabby-bridge 0.0.13-alpha.1 → 0.0.13

package/README.md

@@ -5,166 +5,8 @@ Minimal bridge SDK for Rabby:
 - enumerates supported bridge aggregators and chains
 - maintains per-chain spender/router allowlists
 - validates backend bridge quotes before returning them
-- decodes source transactions for Across, LI.FI, Relay, Socket and Mayan
-- keeps chain-state-dependent output fields explicitly unverified, without RPC requests
-- performs local validation only; no direct-provider HTTP requests or RPC reads
-
-See [calldata parsing](src/calldata/README.md) for supported paths, integration and verification boundaries.
-See [offline provider evidence](src/providers/README.md) for retained historical fixtures and verification limits.
+- does not implement calldata decoding
 
 ## Test
 
 Run `yarn test` to build the package and execute the Jest suite.
-
-See [reachable route discovery](tests/fixtures/route-discovery-20261104/README.md) for the latest parsing changes, fixture coverage and remaining verification limits.
-
-## Validation rollout
-
-The first rollout enforces Router/Spender allowlists and observes local calldata
-validation. No provider API or RPC requests are made. `buildTx` and
-`getQuoteListWithTx` keep the original backend transaction when source, destination
-or receiver checks fail or cannot be completed; `onError` receives those observations.
-
-```ts
-const quotes = await getQuoteListWithTx(aggregatorId, {
-  ...params,
-  onError: (report) => reportToBusiness(report),
-}, api);
-```
-
-- Quotes and transactions come from the existing backend flow, including Relay
-  and Socket, in both modes. The SDK no longer accepts `providerClient` or exposes
-  a direct-provider client/fetch adapter.
-- Router/Spender mismatches, unsupported source chains/aggregators,
-  missing required slippage, missing backend results and backend request failures
-  keep their original blocking behavior.
-- Source token, source amount, supplied sender/chain and protocol structure are
-  checked locally. Missing source fields and mismatches are reported.
-- Socket quote IDs (including CCTP), RFQ outer/vault IDs and Relay multicall
-  request IDs are compared locally when a selected quote provides a matching
-  identifier. Mismatches are reported without blocking or changing field flags;
-  missing/unrecognized keys are skipped. See the [binding limits](src/calldata/README.md).
-- Known destination tokens, minimum amounts and chains are compared. Unknown
-  destination paths remain unverified and are reported with available method,
-  selector and nested-call diagnostics.
-- Locally derivable final receivers are compared. External order data is skipped
-  without a provider request; a skipped receiver is never counted as verified.
-- Parse failures, known mismatches and unexpected missing fields are reported with
-  `blocking: false`, including when `lite` is omitted or false.
-- Relay and Socket RFQ/CCTP external destination fields are skipped rather than
-  fetched. LayerSwap uses its local receiver; no background order lookup runs.
-  Skipping an external receiver does not claim order-hash or provider verification.
-- Known unresolved output token/minimum fields and Relay/Socket external
-  receiver/chain fields stay in `unverifiedFields` without producing reports.
-  Missing source fields, unknown receivers/paths and a missing expected amount
-  for a locally available minimum use `BRIDGE_UNVERIFIED_BRIDGE_FIELDS`.
-  Actual mismatches retain their existing error codes. Repeated failures are not
-  deduplicated, sampled or rate-limited by the SDK.
-
-`validateBridgeQuote` also accepts `{ lite, onError }` as its fourth argument;
-`validateBridgeTx` accepts it after the optional expectation as its sixth argument.
-`lite` retains its legacy missing-spender behavior; it no longer selects strict
-calldata enforcement and never skips a missing Router allowlist.
-
-`validateBridgeTx` now returns `BridgeValidationResult` instead of `true`:
-
-```ts
-const result = validateBridgeTx(aggregatorId, chainId, bridgeId, tx, expectation);
-// result.pass === result.routerPass
-// result.fromPass / result.toPass / result.receiverPass
-// result.unverifiedFields / result.errors
-```
-
-The three field flags are true only when all required local comparisons for that
-group succeeded. False means a failure or an incomplete check; `errors` and
-`unverifiedFields` distinguish them. Known skipped fields can leave `errors` empty
-while a field flag is false. Without an expectation, field flags are false.
-They do not contribute to `pass` in this rollout. Router rejection still throws
-`InvalidBridgeContractError`; its sanitized detail carries `pass: false`,
-`routerPass: false` and `blocking: true`.
-
-Raw decode/calldata-check results retain `ok: false` on failure. Observation
-details include all five pass flags, path diagnostics, `lite` and `blocking: false`.
-These are failure-event/path counts, not distinct user counts or a denominator for
-all successful transactions. See error reporting below for failures that still throw.
-
-## Error reporting
-
-All stable error codes, stages and messages are defined in
-[`BRIDGE_ERRORS`](src/errors/constants.ts). Codes are explicit constants; callers
-must not classify errors by matching message text. Existing error classes and
-legacy `reason` fields remain available.
-
-- `decodeBridgeCalldataResult(aggregatorId, tx)` returns a detailed success/failure
-  result. The existing `decodeBridgeCalldata` still returns `null` on failure.
-- `validateBridgeCalldata` returns `errors`, plus `error_code` and `stage` on failure.
-  Independent intent mismatches are collected together; decoding or dependent
-  protocol operations stop at their first failure.
-- Thrown SDK errors extend `BridgeError`. Use `error.toJSON()` for a report.
-- `onError` receives failures filtered from `getQuote` / `getQuoteListWithTx`,
-  plus local validation failures and unexpected missing fields from transaction checks.
-  Directly thrown errors are handled by the caller, avoiding duplicate reporting.
-  Reporting callback failures do not affect validation or quote filtering.
-
-```ts
-import { BridgeError, getQuoteListWithTx } from '@rabby-wallet/rabby-bridge';
-
-try {
-  const quotes = await getQuoteListWithTx(aggregatorId, {
-    ...params,
-    onError: (report) => reportToBusiness(report),
-  }, api);
-} catch (error) {
-  if (error instanceof BridgeError) reportToBusiness(error.toJSON());
-  throw error;
-}
-```
-
-A report contains a primary `error_code` / `stage` and an `errors` list. The primary
-code is the first failure; inspect the list for every collected failure. Each detail
-contains its fixed message and available context: aggregator, chain, bridge,
-provider, operation, method, selector, nested protocol selector, missing fields or
-HTTP status. SDK reports omit wallet addresses, amounts, raw calldata, response
-bodies and arbitrary transport exception messages. Existing Error messages are
-retained for compatibility; prefer `toJSON()` for reporting.
-
-Stages distinguish input checks, contract allowlists, ABI decoding, protocol
-structure, intent comparison, provider requests, provider responses, transaction
-binding and completeness. Unexpected uncategorized failures use `BRIDGE_UNKNOWN`.
-Deferred chain-state output fields remain in `unverifiedFields` without producing
-reports merely because a known local limitation prevents verification.
-
-### Privacy-safe diagnostics
-
-Use `toBridgeErrorReport(resultOrError)` to convert a calldata check,
-transaction validation result, detailed decode result or exception into a report.
-A transaction with `pass: true` can still produce an observation report when its
-`errors` are nonempty. Results without reportable failures return `undefined`,
-including known skipped destination fields.
-The `onError` callback and `BridgeError.toJSON()` use the same
-runtime allowlist. Do not upload the entire check, exception, parsed transaction,
-request parameters or quote response.
-
-```ts
-const check = validateBridgeTx(aggregatorId, chainId, bridgeId, tx, expectation);
-const report = toBridgeErrorReport(check);
-if (report) reportToBusiness(report);
-```
-
-Reports can retain recognized aggregator/bridge/method labels, source/destination
-chains, outer/router/protocol selectors, call-data format and byte lengths, ABI
-failure offsets, bounded destination-call selectors/counts, unsupported command
-bytes/counts, static request categories and HTTP status. Nested diagnostics are
-collected where the parser knows the call layout; arbitrary payload bytes are not
-scanned for possible selectors. Destination selector lists are deduplicated and
-limited to 16 entries.
-
-Unknown labels become `unknown` or are omitted. Messages and stages are restored
-from the error-code catalogue, even if an error was modified after construction.
-Arbitrary properties are dropped, including wallet/receiver/refund addresses,
-token addresses, amounts, balances, approvals, transaction/order/quote/request IDs,
-signatures, full calldata, URL/query/header/body contents, raw exception messages
-and stack traces. Contract addresses and hashes are not reported either.
-
-These reports identify unsupported function families and failure stages. They
-intentionally cannot reconstruct or identify the original user's transaction.

package/dist/chains.d.ts

@@ -1,6 +1,6 @@
 import { CHAINS_ENUM as DBK_CHAINS_ENUM } from '@debank/common';
 export declare const CHAINS_ENUM: typeof DBK_CHAINS_ENUM;
-export declare const EXTRA_CHAINS: readonly ["XDC", "UNI", "RONIN", "XLAYER", "MONAD", "SONIC", "LENS", "WORLD", "STABLE", "HYPER", "LISK", "SEI", "GRAVITY", "SONEIUM", "SWELL", "ABS", "MORPH", "TEMPO", "MEGAETH", "PLASMA", "APE", "HEMI", "SOPHON", "INK", "BOB", "BERA", "PLUME", "TAIKO", "KATANA", "STORY", "CYBER", "ZIRCUIT", "HOOD", "ARC"];
+export declare const EXTRA_CHAINS: readonly ["XDC", "UNI", "RONIN", "XLAYER", "MONAD", "SONIC", "LENS", "WORLD", "STABLE", "HYPER", "LISK", "SEI", "GRAVITY", "SONEIUM", "SWELL", "ABS", "MORPH", "TEMPO", "MEGAETH", "PLASMA", "APE", "HEMI", "SOPHON", "INK", "BOB", "BERA", "PLUME", "TAIKO", "KATANA", "STORY", "CYBER", "ZIRCUIT", "HOOD", "ARC", "ELYSIUM"];
 export type ExtraChainEnum = (typeof EXTRA_CHAINS)[number];
 export type ChainEnum = DBK_CHAINS_ENUM | ExtraChainEnum;
 export declare const SERVER_ID_TO_CHAIN_ENUM: {
@@ -62,6 +62,7 @@ export declare const SERVER_ID_TO_CHAIN_ENUM: {
     readonly zircuit: ChainEnum;
     readonly hood: ChainEnum;
     readonly arc: ChainEnum;
+    readonly elysium: ChainEnum;
     readonly zora: DBK_CHAINS_ENUM.ZORA;
 };
 export declare const CHAIN_ENUM_TO_SERVER_ID: Record<ChainEnum, string>;

package/dist/chains.js

@@ -35,6 +35,7 @@ export const EXTRA_CHAINS = [
     'ZIRCUIT',
     'HOOD',
     'ARC',
+    'ELYSIUM',
 ];
 export const SERVER_ID_TO_CHAIN_ENUM = {
     eth: CHAINS_ENUM.ETH,
@@ -95,6 +96,7 @@ export const SERVER_ID_TO_CHAIN_ENUM = {
     zircuit: 'ZIRCUIT',
     hood: 'HOOD',
     arc: 'ARC',
+    elysium: 'ELYSIUM',
     zora: CHAINS_ENUM.ZORA,
 };
 export const CHAIN_ENUM_TO_SERVER_ID = Object.fromEntries(Object.entries(SERVER_ID_TO_CHAIN_ENUM).map(([serverId, chainEnum]) => [

package/dist/data.d.ts

@@ -35,6 +35,7 @@ declare const EXTRA_CHAINS: {
     readonly ZIRCUIT: ChainEnum;
     readonly HOOD: ChainEnum;
     readonly ARC: ChainEnum;
+    readonly ELYSIUM: ChainEnum;
 };
 export declare const BRIDGE_SUPPORT_CHAINS_DATA: {
     readonly near_intents: [import("@debank/common").CHAINS_ENUM.ETH, import("@debank/common").CHAINS_ENUM.ARBITRUM, import("@debank/common").CHAINS_ENUM.BASE, import("@debank/common").CHAINS_ENUM.BSC, import("@debank/common").CHAINS_ENUM.POLYGON, import("@debank/common").CHAINS_ENUM.OP, import("@debank/common").CHAINS_ENUM.AVAX, import("@debank/common").CHAINS_ENUM.GNOSIS, import("@debank/common").CHAINS_ENUM.SCRL, ChainEnum, ChainEnum];
@@ -175,6 +176,7 @@ export declare const BRIDGE_SPENDER_WHITELIST_DATA: {
         readonly [EXTRA_CHAINS.PLASMA]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly [EXTRA_CHAINS.HOOD]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly [EXTRA_CHAINS.ARC]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
+        readonly [EXTRA_CHAINS.ELYSIUM]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly ETH: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly OP: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly CRO: "0x59916da825d2d2ec1bf878d71c88826f6633ecca";
@@ -398,6 +400,7 @@ export declare const BRIDGE_ROUTER_WHITELIST_DATA: {
         readonly [EXTRA_CHAINS.PLASMA]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly [EXTRA_CHAINS.HOOD]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly [EXTRA_CHAINS.ARC]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
+        readonly [EXTRA_CHAINS.ELYSIUM]: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly ETH: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly OP: "0x4cd00e387622c35bddb9b4c962c136462338bc31";
         readonly CRO: "0x59916da825d2d2ec1bf878d71c88826f6633ecca";

package/dist/data.js

@@ -44,6 +44,7 @@ const EXTRA_CHAINS = {
     ZIRCUIT: 'ZIRCUIT',
     HOOD: 'HOOD',
     ARC: 'ARC',
+    ELYSIUM: 'ELYSIUM',
 };
 const SOCKET_V3_ALLOWANCE_HOLDER = '0x50c4e75a512f2a14a7b304787adf79c4531a5909';
 const SOCKET_V3_CONTRACTS = {
@@ -218,6 +219,7 @@ export const BRIDGE_SPENDER_WHITELIST_DATA = {
         [EXTRA_CHAINS.PLASMA]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
         [EXTRA_CHAINS.HOOD]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
         [EXTRA_CHAINS.ARC]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
+        [EXTRA_CHAINS.ELYSIUM]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
     },
     stargate: {
         [CHAINS_ENUM.BASE]: '0x8eca03175fd5ac62fb6f4ecbb9a95d13dcdcb4f8',
@@ -439,6 +441,7 @@ export const BRIDGE_ROUTER_WHITELIST_DATA = {
         [EXTRA_CHAINS.PLASMA]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
         [EXTRA_CHAINS.HOOD]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
         [EXTRA_CHAINS.ARC]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
+        [EXTRA_CHAINS.ELYSIUM]: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
     },
     stargate: {
         [CHAINS_ENUM.BASE]: '0x7e07a9148e9149e430c6412b79a675028595ff1f',

package/dist/index.d.ts

@@ -1,10 +1,5 @@
 export { BRIDGE_AGGREGATORS, BRIDGE_ENUM } from './consts.js';
 export type { BridgeAggregatorId } from './consts.js';
 export { ALL_SUPPORTED_BRIDGE_CHAINS, BRIDGE_ROUTER_WHITELIST, BRIDGE_SPENDER_WHITELIST, BRIDGE_SUPPORT_CHAINS, CHAINS_ENUM, getBridgeAltContracts, getBridgeRouter, getBridgeSpender, isSupportedBridgeAggregator, isSupportedBridgeChain, } from './list.js';
-export { CALLDATA_AGGREGATORS, InvalidBridgeCalldataError, decodeBridgeCalldata, decodeBridgeCalldataResult, hasBridgeCalldata, validateBridgeCalldata, } from './calldata/index.js';
-export type { BridgeCalldataTx, BridgeTokenReference, BridgeAmountReference, BridgeCallExpectation, BridgeCheck, DecodeHit, ParsedBridgeCall, } from './calldata/index.js';
 export { InvalidBridgeContractError, buildBridgeQuoteTx, buildTx, getQuote, getQuoteList, getQuoteListWithTx, validateBridgeQuote, validateBridgeTx, } from './quote.js';
-export type { BridgeApi, BridgeBuildTxParams, BridgeQuote, BridgeQuoteListItem, BridgeQuoteListParams, BridgeValidationOptions, BridgeValidationResult, BridgeTx, } from './quote.js';
-export { InvalidBridgeProviderError } from './providers/errors.js';
-export { BRIDGE_ERRORS, BridgeError, toBridgeErrorReport } from './errors/index.js';
-export type { BridgeErrorCode, BridgeErrorStage, BridgeErrorDefinition, BridgeErrorContext, BridgeErrorDetail, BridgeErrorReport, BridgeErrorReporter } from './errors/index.js';
+export type { BridgeApi, BridgeBuildTxParams, BridgeQuote, BridgeQuoteListItem, BridgeQuoteListParams, BridgeTx, } from './quote.js';

package/dist/index.js

@@ -1,6 +1,3 @@
 export { BRIDGE_AGGREGATORS, BRIDGE_ENUM } from './consts.js';
 export { ALL_SUPPORTED_BRIDGE_CHAINS, BRIDGE_ROUTER_WHITELIST, BRIDGE_SPENDER_WHITELIST, BRIDGE_SUPPORT_CHAINS, CHAINS_ENUM, getBridgeAltContracts, getBridgeRouter, getBridgeSpender, isSupportedBridgeAggregator, isSupportedBridgeChain, } from './list.js';
-export { CALLDATA_AGGREGATORS, InvalidBridgeCalldataError, decodeBridgeCalldata, decodeBridgeCalldataResult, hasBridgeCalldata, validateBridgeCalldata, } from './calldata/index.js';
 export { InvalidBridgeContractError, buildBridgeQuoteTx, buildTx, getQuote, getQuoteList, getQuoteListWithTx, validateBridgeQuote, validateBridgeTx, } from './quote.js';
-export { InvalidBridgeProviderError } from './providers/errors.js';
-export { BRIDGE_ERRORS, BridgeError, toBridgeErrorReport } from './errors/index.js';

package/dist/quote.d.ts

@@ -1,26 +1,6 @@
-import type { BridgeErrorReporter } from './errors/index.js';
-import { BridgeError } from './errors/index.js';
 import type { OpenApiService } from '@rabby-wallet/rabby-api';
-import type { BridgeCallExpectation } from './calldata/expect.js';
-import type { BridgeCheck } from './calldata/types.js';
 import type { BridgeAggregatorId } from './consts.js';
-export interface BridgeValidationOptions {
-    /** Retains the legacy missing-spender rollout behavior. Calldata checks are always observation-only. */
-    lite?: boolean;
-    /** Receives filtered failures and non-blocking local validation observations. */
-    onError?: BridgeErrorReporter;
-}
-export type BridgeValidationResult = {
-    /** First rollout: only the router decides whether a transaction passes. */
-    pass: boolean;
-    routerPass: boolean;
-    fromPass: boolean;
-    toPass: boolean;
-    receiverPass: boolean;
-    unverifiedFields: string[];
-    errors: BridgeCheck['errors'];
-};
-export interface BridgeQuoteListParams extends BridgeValidationOptions {
+export interface BridgeQuoteListParams {
     userAddress: string;
     fromChainId: string;
     fromTokenId: string;
@@ -33,14 +13,12 @@ export interface BridgeQuoteListParams extends BridgeValidationOptions {
 export interface BridgeBuildTxParams extends BridgeQuoteListParams {
     bridgeId: string;
     quoteKey?: string | Record<string, unknown>;
-    /** Quoted output in raw units, before applying slippage. */
-    toTokenRawAmount?: string;
 }
 export type BridgeApi = Pick<OpenApiService, 'getBridgeQuoteListV2' | 'getBridgeQuoteV2' | 'buildBridgeTx' | 'getBridgeQuoteTxV2'>;
 export type BridgeQuote = Awaited<ReturnType<BridgeApi['getBridgeQuoteTxV2']>>;
 export type BridgeTx = Awaited<ReturnType<BridgeApi['buildBridgeTx']>> | NonNullable<BridgeQuote['tx']>;
 export type BridgeQuoteListItem = Awaited<ReturnType<BridgeApi['getBridgeQuoteV2']>>[number];
-export declare class InvalidBridgeContractError extends BridgeError {
+export declare class InvalidBridgeContractError extends Error {
     readonly kind: 'spender' | 'router';
     readonly aggregatorId: BridgeAggregatorId;
     readonly chainId: string;
@@ -49,8 +27,8 @@ export declare class InvalidBridgeContractError extends BridgeError {
     readonly bridgeId?: string | undefined;
     constructor(kind: 'spender' | 'router', aggregatorId: BridgeAggregatorId, chainId: string, expected: string, received: string, bridgeId?: string | undefined);
 }
-export declare const validateBridgeQuote: (aggregatorId: BridgeAggregatorId, fromChainId: string, quote: BridgeQuoteListItem, options?: BridgeValidationOptions) => boolean;
-export declare const validateBridgeTx: (aggregatorId: BridgeAggregatorId, fromChainId: string, bridgeId: string, tx: BridgeTx, expectation?: BridgeCallExpectation, options?: BridgeValidationOptions) => BridgeValidationResult;
+export declare const validateBridgeQuote: (aggregatorId: BridgeAggregatorId, fromChainId: string, quote: BridgeQuoteListItem) => boolean;
+export declare const validateBridgeTx: (aggregatorId: BridgeAggregatorId, fromChainId: string, bridgeId: string, tx: BridgeTx) => boolean;
 export declare const getQuote: (aggregatorId: string, params: BridgeQuoteListParams, api: BridgeApi) => Promise<BridgeQuoteListItem[]>;
 export declare const buildTx: (aggregatorId: string, params: BridgeBuildTxParams, api: BridgeApi) => Promise<BridgeTx>;
 export declare const getQuoteListWithTx: (aggregatorId: string, params: BridgeQuoteListParams, api: BridgeApi) => Promise<Array<BridgeQuoteListItem & {