@pancakeswap/swap-sdk-evm 1.2.1 → 1.3.0

package/dist/abis/B20.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Base B20 Asset ABI fragments (Coinbase's `IB20Asset`).
+ *
+ * B20's ASSET variant has the same cosmetic display multiplier as ERC-8056, under different names.
+ * Probed on Base mainnet 2026-07-28: `multiplier()` / `WAD_PRECISION()` / `toScaledBalance()` work;
+ * `uiMultiplier()`, the pending getters and ALL of `supportsInterface()` revert. ERC-8056
+ * conformance exists in base-std (PR #173) but is not deployed.
+ *
+ * https://docs.base.org/base-chain/specs/upgrades/beryl/b20
+ */
+export declare const b20AssetAbi: readonly [{
+    readonly type: "function";
+    readonly name: "multiplier";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "WAD_PRECISION";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "toScaledBalance";
+    readonly inputs: readonly [{
+        readonly name: "rawBalance";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "toRawBalance";
+    readonly inputs: readonly [{
+        readonly name: "scaledBalance";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "rawBalance";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "scaledBalanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "UIMultiplierUpdated";
+    readonly inputs: readonly [{
+        readonly name: "oldMultiplier";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "newMultiplier";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "effectiveAtTimestamp";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "MultiplierUpdateCancelled";
+    readonly inputs: readonly [{
+        readonly name: "cancelledMultiplier";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "cancelledEffectiveAt";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}];
+//# sourceMappingURL=B20.d.ts.map

package/dist/abis/B20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"B20.d.ts","sourceRoot":"","sources":["../../src/abis/B20.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4Dd,CAAA"}

package/dist/b20.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Base B20 — extension module for the scaled-UI subsystem.
+ *
+ * Owns everything B20-specific: address recognition, precompile addresses, revert decoding.
+ * Nothing outside this file and its ABI sibling needs to know B20 exists.
+ *
+ * Detection is by address prefix, not ERC-165: `supportsInterface` REVERTS on live B20 tokens for
+ * every id including ERC-165's own, so the probe could only ever answer "no". Addresses are
+ * self-describing instead — `[10-byte prefix][1-byte variant][9-byte keccak(deployer, salt)]` —
+ * so the variant is recoverable with zero RPC.
+ *
+ * https://docs.base.org/base-chain/specs/upgrades/beryl/b20
+ */
+import { ChainId } from '@pancakeswap/chains';
+import type { Address } from 'viem';
+/** Detection is gated on these so a `0xb2000…` vanity address elsewhere can't be mistaken for B20. */
+export declare const B20_SUPPORTED_CHAIN_IDS: readonly [ChainId.BASE, ChainId.BASE_SEPOLIA];
+export type B20SupportedChainId = (typeof B20_SUPPORTED_CHAIN_IDS)[number];
+/** The 10-byte prefix shared by every B20 token, lowercase, without `0x`. */
+export declare const B20_ADDRESS_PREFIX: "b2000000000000000000";
+/** Encoded in address byte `[10]`. */
+export declare enum B20Variant {
+    ASSET = 0,
+    STABLECOIN = 1
+}
+export declare const B20_FACTORY_ADDRESS: "0xB20f000000000000000000000000000000000000";
+export declare const B20_ACTIVATION_REGISTRY_ADDRESS: "0x8453000000000000000000000000000000000001";
+export declare const B20_POLICY_REGISTRY_ADDRESS: "0x8453000000000000000000000000000000000002";
+export declare function isB20SupportedChainId(chainId?: number): chainId is B20SupportedChainId;
+/** Chain-agnostic. Verified equivalent to the factory's own `isB20()` over 24 cases. */
+export declare function isB20Address(address?: string | null): boolean;
+export declare function getB20Variant(address?: string | null): B20Variant | undefined;
+/** Only the ASSET variant carries a multiplier, so a B20 stablecoin must not be treated as scaled. */
+export declare function isB20AssetToken(chainId?: number, address?: string | null): boolean;
+export declare const isB20AssetAddress: (chainId: number | undefined, address: Address | undefined) => boolean;
+/**
+ * B20 raises ABI-encoded custom errors, and a swap reverts through the router — whose ABI doesn't
+ * declare them — so viem can't name them and only the bare 4-byte selector survives. Matching it is
+ * the only reliable hook. `PausableFeature` is an enum, hence `uint8`. Verified against `IB20.sol`.
+ */
+export declare const B20_ERROR_SELECTORS: {
+    readonly '0xa43fec12': "PolicyForbids";
+    readonly '0xfd8c4245': "ContractPaused";
+    readonly '0xcccad523': "PolicyNotFound";
+    readonly '0xcdd98a4a': "UnsupportedPolicyType";
+    readonly '0xf58f733a': "SupplyCapExceeded";
+    readonly '0x6f12f3dc': "InvalidMultiplier";
+};
+export type B20ErrorName = (typeof B20_ERROR_SELECTORS)[keyof typeof B20_ERROR_SELECTORS];
+export declare const B20_PAUSABLE_FEATURES: readonly ["TRANSFER", "MINT", "BURN"];
+export type B20PausableFeature = (typeof B20_PAUSABLE_FEATURES)[number];
+export type B20RevertMatch = {
+    name: B20ErrorName;
+    /** Only for `ContractPaused`, when the revert data carried a decodable feature. */
+    feature?: B20PausableFeature;
+};
+/**
+ * Scan an error payload for a known B20 custom error. Takes a flattened string so it stays
+ * dependency-free; returns `undefined` so callers keep their generic handling.
+ */
+export declare function matchB20RevertError(input?: string | null): B20RevertMatch | undefined;
+//# sourceMappingURL=b20.d.ts.map

package/dist/b20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"b20.d.ts","sourceRoot":"","sources":["../src/b20.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,sGAAsG;AACtG,eAAO,MAAM,uBAAuB,+CAAgD,CAAA;AAEpF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1E,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAG,sBAA+B,CAAA;AAEjE,sCAAsC;AACtC,oBAAY,UAAU;IACpB,KAAK,IAAI;IACT,UAAU,IAAI;CACf;AAED,eAAO,MAAM,mBAAmB,EAAG,4CAAqD,CAAA;AACxF,eAAO,MAAM,+BAA+B,EAAG,4CAAqD,CAAA;AACpG,eAAO,MAAM,2BAA2B,EAAG,4CAAqD,CAAA;AAShG,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,IAAI,mBAAmB,CAEtF;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAI7D;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAW7E;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAElF;AAED,eAAO,MAAM,iBAAiB,YAAa,MAAM,GAAG,SAAS,WAAW,OAAO,GAAG,SAAS,KAAG,OAC3D,CAAA;AAMnC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA;AAEzF,eAAO,MAAM,qBAAqB,uCAAwC,CAAA;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,YAAY,CAAA;IAClB,mFAAmF;IACnF,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B,CAAA;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,CAkBrF"}

package/dist/constants.d.ts

@@ -1,3 +1,4 @@
+import { ChainId } from '@pancakeswap/chains';
 import { Percent } from '@pancakeswap/swap-sdk-core';
 import { ERC20Token } from './entities/erc20Token';
 export declare const ZERO_PERCENT: Percent;
@@ -32,29 +33,16 @@ export declare const WBNB: {
     5611: ERC20Token;
     204: ERC20Token;
 };
-export declare const WNATIVE: {
-    1: ERC20Token;
-    5: ERC20Token;
-    56: ERC20Token;
-    97: ERC20Token;
-    42161: ERC20Token;
-    421613: ERC20Token;
-    324: ERC20Token;
-    280: ERC20Token;
-    59144: ERC20Token;
-    59140: ERC20Token;
-    5611: ERC20Token;
-    204: ERC20Token;
-    8453: ERC20Token;
-    84531: ERC20Token;
-    534351: ERC20Token;
-    11155111: ERC20Token;
-    421614: ERC20Token;
-    84532: ERC20Token;
-    143: ERC20Token;
-    10143: ERC20Token;
-    4663: ERC20Token;
-};
+export declare const WNATIVE: Partial<Record<ChainId, ERC20Token>>;
+/**
+ * The ERC-20 a chain's native currency wraps into.
+ *
+ * Not every EVM chain has one: on Arc the native USDC already satisfies IERC20, so
+ * nothing wraps it and the chain is absent here. Read it through
+ * {@link getWrappedNative} rather than indexing directly, so the missing case has to
+ * be handled instead of blowing up at the first property access.
+ */
+export declare const getWrappedNative: (chainId: ChainId) => ERC20Token | undefined;
 export declare const NATIVE: {
     1: {
         readonly name: "Ether";
@@ -67,7 +55,7 @@ export declare const NATIVE: {
         decimals: number;
     };
     56: {
-        readonly name: "Binance Chain Native Token";
+        readonly name: "BNB Chain Native Token";
         readonly symbol: "BNB";
         readonly decimals: 18;
     };
@@ -107,7 +95,7 @@ export declare const NATIVE: {
         readonly decimals: 18;
     };
     204: {
-        readonly name: "Binance Chain Native Token";
+        readonly name: "BNB Chain Native Token";
         readonly symbol: "BNB";
         readonly decimals: 18;
     };
@@ -161,5 +149,10 @@ export declare const NATIVE: {
         readonly symbol: "ETH";
         readonly decimals: 18;
     };
+    5042: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
 };
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,eAAO,MAAM,YAAY,SAAmB,CAAA;AAC5C,eAAO,MAAM,mBAAmB,SAAmB,CAAA;AAEnD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;CAyKjB,CAAA;AAED,eAAO,MAAM,IAAI;;;;;;CAyChB,CAAA;AAED,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;CAsB4B,CAAA;AAUhD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DlB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,eAAO,MAAM,YAAY,SAAmB,CAAA;AAC5C,eAAO,MAAM,mBAAmB,SAAmB,CAAA;AAEnD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;CAyKjB,CAAA;AAED,eAAO,MAAM,IAAI;;;;;;CAyChB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAsBxD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,UAAU,GAAG,SAA6B,CAAA;AAU9F,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmElB,CAAA"}

package/dist/entities/native.d.ts

@@ -12,7 +12,26 @@ export declare class Native extends NativeCurrency {
     });
     get wrapped(): Token;
     private static cache;
+    /**
+     * The chain's RPC-native currency.
+     *
+     * On a chain that wraps nothing, this instance is a hazard rather than a convenience: its
+     * `wrapped` getter throws, and the repo has ~900 unguarded `.wrapped` reads, so one leaking
+     * into the UI takes a page down somewhere far from where it was created. Those chains are
+     * meant to go through `resolveNativeCurrency`, which hands back the ERC-20 they declare.
+     *
+     * Constructing one anyway is therefore almost always a mistake, and this fails loudly at the
+     * point of construction — where it can be traced — rather than five frames deep in a getter
+     * on an unrelated screen. Only outside production: a wrong page beats a blank one, and the
+     * existing behaviour is what ships today.
+     *
+     * Gas and balance arithmetic genuinely needs the RPC native and its decimals. Those call
+     * sites use {@link getRpcNative}, which is greppable, so they read as a deliberate whitelist
+     * instead of disappearing into the same 81 anonymous `Native.onChain` calls.
+     */
     static onChain(chainId: number): Native;
+    /** @internal shared by `onChain` and `getRpcNative` — the actual construction. */
+    static rpcNative(chainId: number): Native;
     equals(other: Currency): boolean;
 }
 //# sourceMappingURL=native.d.ts.map

package/dist/entities/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/entities/native.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAI5E;;;GAGG;AACH,qBAAa,MAAO,SAAQ,cAAc;IACxC,SAAS,aAAa,EACpB,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,MAAM,GACP,EAAE;QACD,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb;IAID,IAAW,OAAO,IAAI,KAAK,CAI1B;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAoC;WAE1C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAUvC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAGxC"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/entities/native.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAI5E;;;GAGG;AACH,qBAAa,MAAO,SAAQ,cAAc;IACxC,SAAS,aAAa,EACpB,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,MAAM,GACP,EAAE;QACD,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb;IAID,IAAW,OAAO,IAAI,KAAK,CAI1B;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAoC;IAExD;;;;;;;;;;;;;;;;OAgBG;WACW,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAW9C,kFAAkF;WACpE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAUzC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAGxC"}

package/dist/index.d.ts

@@ -3,7 +3,10 @@ export * from './entities';
 export * from './abis/ERC20';
 export * from './abis/ERC165';
 export * from './abis/ScaledUIAmount';
+export * from './abis/B20';
 export * from './utils';
 export * from './ether';
 export * from './scaledUIAmount';
+export * from './b20';
+export * from './resolveNativeCurrency';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,OAAO,CAAA;AACrB,cAAc,yBAAyB,CAAA"}