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

package/README.md

@@ -5,138 +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
-- validates Relay orders, three Socket routes and LI.FI LayerSwap through direct provider requests
-
-See [calldata parsing](src/calldata/README.md) for supported paths, integration and verification boundaries.
-See [direct provider integration](src/providers/README.md) for the shared extension/mobile
-transport interface, quote binding, application-fee constraints and signing checks.
+- 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.
-
-## Lite rollout
-
-Pass `lite: true` to `getQuote`, `buildTx` or `getQuoteListWithTx` to observe new
-validation without letting it change the business decisions from `main`.
-The default is `false`, retaining strict behavior.
-
-```ts
-const quotes = await getQuoteListWithTx(aggregatorId, {
-  ...params,
-  lite: true,
-  onError: (report) => reportToBusiness(report),
-}, api);
-```
-
-- Quotes and transactions come from the existing backend flow, including Relay
-  and Socket. Provider quotes never replace the selected backend quote in lite mode.
-- Configured Router/Spender mismatches, unsupported source chains/aggregators,
-  missing required slippage, missing backend results and backend request failures
-  keep their original blocking behavior.
-- Calldata parsing, intent comparison, missing-field checks, stricter missing
-  contract configuration and provider verification still run against the returned
-  transaction. Their failures are reported without discarding that quote/transaction.
-- No parser is reported as unsupported, including aggregators that strict mode
-  does not currently parse. It is never reported as a successful parse.
-- Relay/Socket verification uses available proof/cache for the selected transaction.
-  If that proof or client is missing, the original missing-proof error is reported;
-  dependent hash/order checks cannot complete. An unrelated fresh provider quote
-  is not fetched or used as evidence for the backend transaction.
-- LayerSwap lookup runs in the background in lite mode. Its result is reported
-  through `onError` and does not delay returning the backend transaction.
-
-`validateBridgeQuote` also accepts `{ lite, onError }` as its fourth argument;
-`validateBridgeTx` accepts it after the optional expectation as its sixth argument.
-Raw decode/calldata-check results remain truthful (`ok: false` on failure).
-Direct provider-client methods remain strict; use the high-level entry points for
-lite rollout decisions.
-
-Error codes and details are preserved. Lite observations carry `lite: true` and
-`blocking: false`; legacy failures carry `blocking: true` when reported by the
-high-level flow. Keep the callback installed while background checks are pending.
-Dependent checks still stop at their first unusable prerequisite, and independent
-stages may emit multiple reports. These are failure-event/path counts, not distinct
-user counts or a denominator for all successful transactions. No user identifiers
-are added. See error reporting below for catching 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`.
-  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`; they do not
-become errors merely because RPC validation is postponed.
-
-### Privacy-safe diagnostics
-
-Use `toBridgeErrorReport(resultOrError)` to convert a failed calldata check,
-detailed decode result or exception into a report. Passing a successful result
-returns `undefined`. 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 = validateBridgeCalldata(aggregatorId, chainId, 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,11 +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, BridgeTx, } from './quote.js';
-export { BRIDGE_PROVIDER_ORIGINS, InvalidBridgeProviderError, createBridgeFetchRequest, createBridgeProviderClient, isDirectBridgeProviderRoute, } from './providers/index.js';
-export type { BridgeFetch, BridgeProviderClient, BridgeProviderClientOptions, BridgeProviderVerification, BridgeVerificationProvider, BridgeServiceRequest, DirectBridgeProvider, } from './providers/index.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 { BRIDGE_PROVIDER_ORIGINS, InvalidBridgeProviderError, createBridgeFetchRequest, createBridgeProviderClient, isDirectBridgeProviderRoute, } from './providers/index.js';
-export { BRIDGE_ERRORS, BridgeError, toBridgeErrorReport } from './errors/index.js';

package/dist/quote.d.ts

@@ -1,16 +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 { BridgeProviderClient } from './providers/types.js';
 import type { BridgeAggregatorId } from './consts.js';
-export interface BridgeValidationOptions {
-    /** Observe new validation failures while preserving main's business decisions. Defaults to false. */
-    lite?: boolean;
-    /** Receives filtered failures and non-blocking lite validation failures. */
-    onError?: BridgeErrorReporter;
-}
-export interface BridgeQuoteListParams extends BridgeValidationOptions {
+export interface BridgeQuoteListParams {
     userAddress: string;
     fromChainId: string;
     fromTokenId: string;
@@ -19,20 +9,16 @@ export interface BridgeQuoteListParams extends BridgeValidationOptions {
     toTokenId: string;
     slippage?: string;
     feeRate?: number;
-    /** Reuse the same client for quoting/building; transport connects directly to providers. */
-    providerClient?: BridgeProviderClient;
 }
 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;
@@ -41,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) => boolean;
+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 & {