@avaprotocol/protocols 0.1.0 → 0.3.0

package/README.md

@@ -23,9 +23,9 @@ const sig  = Protocols.aaveV3.eventTopics.Borrow;
 
 | Protocol | Contracts | Chains |
 |---|---|---|
-| **AAVE V3** | Pool, Oracle, WETH Gateway + Pool methods/events ABI + topics | Mainnet, Sepolia, Base, Base Sepolia |
+| **AAVE V3** | Pool, Oracle, WETH Gateway + Pool methods/events ABI + topics | Mainnet, Sepolia, Base, Base Sepolia, **BNB** (no WETH Gateway on BNB) |
 | **Aerodrome** | Router | Base |
-| **Chainlink** | ETH/USD + BTC/USD feeds + AggregatorV3 ABI | Mainnet, Sepolia |
+| **Chainlink** | ETH/USD + BTC/USD + BNB/USD feeds + AggregatorV3 ABI | Mainnet, Sepolia, **BNB** (BNB/USD is BNB-only) |
 | **Compound V3** | USDC Comet market | Mainnet, Base |
 | **Ethena** | USDe, sUSDe vault + custom (cooldown-aware) ABI | Mainnet |
 | **Frax Ether** | frxETH, sfrxETH vault + standard ERC-4626 ABI | Mainnet |
@@ -34,9 +34,9 @@ const sig  = Protocols.aaveV3.eventTopics.Borrow;
 | **Rocket Pool** | rETH + L1 burn/rate/value ABI | Mainnet, Base (bridged) |
 | **Sky (sDAI)** | sDAI vault + standard ERC-4626 ABI | Mainnet |
 | **Spark** | SparkLend Pool (AAVE V3 fork — reuse AAVE Pool ABI) | Mainnet |
-| **Superfluid** | CFAv1Forwarder + setFlowrate/createFlow ABI | Mainnet, Base |
-| **Uniswap V3** | SwapRouter02, QuoterV2, Permit2, Factory, NFT Position Manager, Universal Router + ABIs | Mainnet, Sepolia, Base, Base Sepolia |
-| **Wrapped Ether** | WETH per chain + WETH9 ABI | Mainnet, Sepolia, Base, Base Sepolia |
+| **Superfluid** | CFAv1Forwarder + setFlowrate/createFlow ABI | Mainnet, Base, **BNB** |
+| **Uniswap V3** | SwapRouter02, QuoterV2, Permit2, Factory, NFT Position Manager, Universal Router + ABIs | Mainnet, Sepolia, Base, Base Sepolia, **BNB** |
+| **Wrapped Ether** | Canonical wrapper of native gas + WETH9 ABI (WBNB on BNB) | Mainnet, Sepolia, Base, Base Sepolia, **BNB** |
 | **ERC-20** | Standard `approve` ABI fragment | n/a |
 
 Shared ABIs (consumed by multiple protocol modules):
@@ -149,6 +149,85 @@ There's no equivalent multi-protocol + multi-chain + addresses + ABIs + topics p
 
 Address verification: link to the canonical source (Etherscan-verified deployment, protocol docs, official address book). PRs that don't cite a source for the addresses won't merge.
 
+## Tokens sidecar (for non-TS consumers)
+
+`yarn build` writes a per-chain JSON file under `dist/tokens/` alongside the JS + d.ts outputs:
+
+```
+dist/tokens/
+├── ethereum.json       (chain 1)
+├── sepolia.json        (chain 11155111)
+├── base.json           (chain 8453)
+├── base-sepolia.json   (chain 84532)
+├── bnb-mainnet.json    (chain 56)
+└── holesky.json        (chain 17000)
+```
+
+Each file is a stable-sorted array of `{ id, name, symbol, decimals }` entries — the same schema the EigenLayer-AVS Go aggregator already consumes under `token_whitelist/*.json`, so a Go service can pick up the catalog without depending on the TS toolchain. `id` is the lowercased address (matching Go's read-side normalization). Metadata fields TS consumers use (`description`, `website`, `logoUrl`, `links`) are intentionally omitted; TS callers import the `Tokens` namespace from source instead.
+
+### When to run it
+
+- **Automatically** — `yarn build` invokes `yarn build:tokens-sidecar` as its last step, so any release publishes a fresh sidecar in the npm tarball.
+- **Standalone** — `yarn build:tokens-sidecar` when you've edited `src/tokens/` and want to inspect the generated JSON without rebuilding declarations + JS.
+
+### Adding a new chain
+
+The script throws fast if the catalog grows a token on a chain that isn't registered in `CHAIN_FILE_NAMES` inside `scripts/build-tokens-sidecar.ts`:
+
+```
+[tokens-sidecar] no file name registered for chain <id>.
+Add it to CHAIN_FILE_NAMES in scripts/build-tokens-sidecar.ts.
+```
+
+Fix is one line — append `[Chains.NewChain]: "newchain-mainnet"` to the map. The error message points at the exact file so this can't silently ship an incomplete sidecar.
+
+### Consuming the sidecar (Go example)
+
+```go
+// EigenLayer-AVS already does this for its checked-in
+// token_whitelist/*.json; the dist/tokens/*.json from this package
+// match the same schema.
+type tokenEntry struct {
+    ID       string `json:"id"`
+    Name     string `json:"name"`
+    Symbol   string `json:"symbol"`
+    Decimals int    `json:"decimals"`
+}
+
+raw, err := os.ReadFile("path/to/dist/tokens/sepolia.json")
+// ... json.Unmarshal(raw, &entries) ...
+```
+
+## Releasing
+
+This package uses [changesets](https://github.com/changesets/changesets) for versioning. The day-to-day flow:
+
+```bash
+# 1. Make your code changes on a feature branch.
+yarn changeset                   # interactive prompt; pick bump level + write the changelog entry
+git add .changeset && git commit -m "..."
+git push                         # open PR as normal
+```
+
+When the PR merges to `main`, the `Release` workflow (`.github/workflows/release.yml`) either:
+
+- Opens (or updates) a "Version Packages" PR that runs `yarn changeset version` — bumps `package.json` + writes `CHANGELOG.md`. Review and merge that PR.
+- Or, if there are no pending changesets, runs `yarn release` (`yarn build && yarn changeset publish`) — which publishes to npm with the right dist-tag automatically (stable → `latest`, pre-release → its identifier).
+
+### Publishing manually (escape hatch)
+
+If you need to publish without the GitHub Action — e.g. an emergency release from a machine that has `npm login` credentials:
+
+```bash
+yarn build                        # produces dist/ + tokens sidecar
+npm whoami                        # verify logged in
+npm publish --access public       # for stable versions; goes to `latest`
+# or for a pre-release:
+npm publish --access public --tag dev
+```
+
+`prepublishOnly: yarn build` runs the build chain automatically if you forget, so even `npm publish` alone is safe.
+
 ## Versioning
 
 Semver. Until `1.0.0`, breaking changes can land in minor versions (`0.x`), but address corrections are always patches.

package/dist/chains.d.ts

@@ -4,6 +4,7 @@ export declare const Chains: Readonly<{
     Holesky: 17000;
     BaseMainnet: 8453;
     BaseSepolia: 84532;
+    BnbMainnet: 56;
 }>;
 export type ChainId = (typeof Chains)[keyof typeof Chains] | number;
 //# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM;;;;;;EAMjB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM;;;;;;;EAOjB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC"}

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   Chains: () => Chains,
   Protocols: () => Protocols,
+  Tokens: () => Tokens,
   aaveV3: () => aaveV3,
   aerodrome: () => aerodrome,
   aggregatorV3Abi: () => aggregatorV3Abi,
@@ -32,6 +33,7 @@ __export(index_exports, {
   ethena: () => ethena,
   fraxEther: () => fraxEther,
   lido: () => lido,
+  lookupToken: () => lookupToken,
   morphoBlue: () => morphoBlue,
   rocketPool: () => rocketPool,
   sky: () => sky,
@@ -48,7 +50,8 @@ var Chains = Object.freeze({
   Sepolia: 11155111,
   Holesky: 17e3,
   BaseMainnet: 8453,
-  BaseSepolia: 84532
+  BaseSepolia: 84532,
+  BnbMainnet: 56
 });
 
 // src/protocols/aave-v3.ts
@@ -56,13 +59,15 @@ var pool = {
   [Chains.EthereumMainnet]: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
   [Chains.Sepolia]: "0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951",
   [Chains.BaseMainnet]: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
-  [Chains.BaseSepolia]: "0x8bAB6d1b75f19e9eD9fCe8b9BD338844fF79aE27"
+  [Chains.BaseSepolia]: "0x8bAB6d1b75f19e9eD9fCe8b9BD338844fF79aE27",
+  [Chains.BnbMainnet]: "0x6807dc923806fE8Fd134338EABCA509979a7e0cB"
 };
 var oracle = {
   [Chains.EthereumMainnet]: "0x54586bE62E3c3580375aE3723C145253060Ca0C2",
   [Chains.Sepolia]: "0x2da88497588bf89281816106C7259e31AF45a663",
   [Chains.BaseMainnet]: "0x2Cc0Fc26eD4563A5ce5e8bdcfe1A2878676Ae156",
-  [Chains.BaseSepolia]: "0x943b0dE18d4abf4eF02A85912F8fc07684C141dF"
+  [Chains.BaseSepolia]: "0x943b0dE18d4abf4eF02A85912F8fc07684C141dF",
+  [Chains.BnbMainnet]: "0x39bc1bfDa2130d6Bb6DBEfd366939b4c7aa7C697"
 };
 var wethGateway = {
   [Chains.EthereumMainnet]: "0xd01607c3C5eCABa394D8be377a08590149325722",
@@ -303,14 +308,20 @@ var erc4626VaultAbi = Object.freeze([
 // src/protocols/chainlink.ts
 var ethUsdFeed = {
   [Chains.EthereumMainnet]: "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
-  [Chains.Sepolia]: "0x694AA1769357215DE4FAC081bf1f309aDC325306"
+  [Chains.Sepolia]: "0x694AA1769357215DE4FAC081bf1f309aDC325306",
+  [Chains.BnbMainnet]: "0x9ef1B8c0E4F7dc8bF5719Ea496883DC6401d5b2e"
 };
 var btcUsdFeed = {
-  [Chains.EthereumMainnet]: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c"
+  [Chains.EthereumMainnet]: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c",
+  [Chains.BnbMainnet]: "0x264990fbd0A4796A3E3d8E37C4d5F87a3aCa5Ebf"
+};
+var bnbUsdFeed = {
+  [Chains.BnbMainnet]: "0x0567F2323251f0Aab15c8dFb1967E4e8A7D42aeE"
 };
 var chainlink = Object.freeze({
   ethUsdFeed,
   btcUsdFeed,
+  bnbUsdFeed,
   /** Shared AggregatorV3 ABI — works for any Chainlink feed. */
   aggregatorV3Abi
 });
@@ -578,7 +589,8 @@ var spark = Object.freeze({
 // src/protocols/superfluid.ts
 var cfaForwarder = {
   [Chains.EthereumMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125",
-  [Chains.BaseMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125"
+  [Chains.BaseMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125",
+  [Chains.BnbMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125"
 };
 var cfaForwarderAbi = Object.freeze([
   {
@@ -616,37 +628,43 @@ var swapRouter02 = {
   [Chains.EthereumMainnet]: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
   [Chains.Sepolia]: "0x3bFA4769FB09eefC5a80d6E87c3B9C650f7Ae48E",
   [Chains.BaseMainnet]: "0x2626664c2603336E57B271c5C0b26F421741e481",
-  [Chains.BaseSepolia]: "0x94cC0AaC535CCDB3C01d6787D6413C739ae12bc4"
+  [Chains.BaseSepolia]: "0x94cC0AaC535CCDB3C01d6787D6413C739ae12bc4",
+  [Chains.BnbMainnet]: "0xB971eF87ede563556b2ED4b1C0b0019111Dd85d2"
 };
 var quoterV2 = {
   [Chains.EthereumMainnet]: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e",
   [Chains.Sepolia]: "0xEd1f6473345F45b75F8179591dd5bA1888cf2FB3",
   [Chains.BaseMainnet]: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a",
-  [Chains.BaseSepolia]: "0xC5290058841028F1614F3A6F0F5816cAd0df5E27"
+  [Chains.BaseSepolia]: "0xC5290058841028F1614F3A6F0F5816cAd0df5E27",
+  [Chains.BnbMainnet]: "0x78D78E420Da98ad378D7799bE8f4AF69033EB077"
 };
 var permit2 = {
   [Chains.EthereumMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
   [Chains.Sepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
   [Chains.BaseMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
-  [Chains.BaseSepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3"
+  [Chains.BaseSepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
+  [Chains.BnbMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3"
 };
 var factory = {
   [Chains.EthereumMainnet]: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
   [Chains.Sepolia]: "0x0227628f3F023bb0B980b67D528571c95c6DaC1c",
   [Chains.BaseMainnet]: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD",
-  [Chains.BaseSepolia]: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24"
+  [Chains.BaseSepolia]: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24",
+  [Chains.BnbMainnet]: "0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7"
 };
 var nonfungiblePositionManager = {
   [Chains.EthereumMainnet]: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
   [Chains.Sepolia]: "0x1238536071E1c677A632429e3655c799b22cDA52",
   [Chains.BaseMainnet]: "0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1",
-  [Chains.BaseSepolia]: "0x27F971cb582BF9E50F397e4d29a5C7A34f11faA2"
+  [Chains.BaseSepolia]: "0x27F971cb582BF9E50F397e4d29a5C7A34f11faA2",
+  [Chains.BnbMainnet]: "0x7b8A01B39D58278b5DE7e48c8449c9f4F5170613"
 };
 var universalRouter = {
   [Chains.EthereumMainnet]: "0x66a9893cc07d91d95644aedd05d03f95e1dba8af",
   [Chains.Sepolia]: "0x3A9D48AB9751398BbFa63ad67599Bb04e4BdF98b",
   [Chains.BaseMainnet]: "0x6ff5693b99212da76ad316178a184ab56d299b43",
-  [Chains.BaseSepolia]: "0x492e6456d9528771018deb9e87ef7750ef184104"
+  [Chains.BaseSepolia]: "0x492e6456d9528771018deb9e87ef7750ef184104",
+  [Chains.BnbMainnet]: "0x4Dae2f939ACf50408e13d58534Ff8c2776d45265"
 };
 var swapRouter02Abi = Object.freeze([
   {
@@ -739,13 +757,15 @@ var tokens2 = Object.freeze({
     [Chains.Sepolia]: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
     [Chains.EthereumMainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
     [Chains.BaseMainnet]: "0x4200000000000000000000000000000000000006",
-    [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006"
+    [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006",
+    [Chains.BnbMainnet]: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
   },
   USDC: {
     [Chains.Sepolia]: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
     [Chains.EthereumMainnet]: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
     [Chains.BaseMainnet]: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-    [Chains.BaseSepolia]: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+    [Chains.BaseSepolia]: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    [Chains.BnbMainnet]: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"
   }
 });
 var uniswapV3 = Object.freeze({
@@ -766,7 +786,9 @@ var weth = {
   [Chains.EthereumMainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
   [Chains.Sepolia]: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
   [Chains.BaseMainnet]: "0x4200000000000000000000000000000000000006",
-  [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006"
+  [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006",
+  // BNB Chain's native is BNB, not ETH — this entry is WBNB.
+  [Chains.BnbMainnet]: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
 };
 var wethAbi = Object.freeze([
   {
@@ -824,10 +846,176 @@ var Protocols = Object.freeze({
   uniswapV3,
   wrapped
 });
+
+// src/tokens/index.ts
+var USDC = {
+  [Chains.EthereumMainnet]: {
+    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    decimals: 6,
+    name: "USD Coin",
+    description: "Fully-reserved USD stablecoin issued by Circle.",
+    website: "https://www.circle.com/usdc",
+    explorer: "https://etherscan.io/token/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/USDC.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/usd-coin",
+      coinmarketcap: "https://coinmarketcap.com/currencies/usd-coin/"
+    }
+  },
+  [Chains.BaseMainnet]: {
+    address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    decimals: 6,
+    name: "USD Coin",
+    explorer: "https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  },
+  [Chains.Sepolia]: {
+    address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    decimals: 6,
+    name: "USD Coin (Sepolia)",
+    explorer: "https://sepolia.etherscan.io/token/0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
+  },
+  [Chains.BaseSepolia]: {
+    address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    decimals: 6,
+    name: "USD Coin (Base Sepolia)",
+    explorer: "https://sepolia.basescan.org/token/0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+  },
+  [Chains.BnbMainnet]: {
+    address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+    decimals: 18,
+    name: "Binance-Peg USD Coin",
+    explorer: "https://bscscan.com/token/0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"
+  }
+};
+var USDT = {
+  [Chains.EthereumMainnet]: {
+    address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+    decimals: 6,
+    name: "Tether USD",
+    description: "USD-pegged stablecoin issued by Tether.",
+    website: "https://tether.to",
+    explorer: "https://etherscan.io/token/0xdAC17F958D2ee523a2206206994597C13D831ec7",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/USDT.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/tether",
+      coinmarketcap: "https://coinmarketcap.com/currencies/tether/"
+    }
+  },
+  [Chains.BnbMainnet]: {
+    address: "0x55d398326f99059fF775485246999027B3197955",
+    decimals: 18,
+    name: "Binance-Peg Tether USD",
+    explorer: "https://bscscan.com/token/0x55d398326f99059fF775485246999027B3197955"
+  }
+};
+var WETH = {
+  [Chains.EthereumMainnet]: {
+    address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+    decimals: 18,
+    name: "Wrapped Ether",
+    description: "ERC-20 wrapper around native ETH, 1:1 backed.",
+    explorer: "https://etherscan.io/token/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/WETH.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/weth"
+    }
+  },
+  [Chains.Sepolia]: {
+    address: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
+    decimals: 18,
+    name: "Wrapped Ether (Sepolia)",
+    explorer: "https://sepolia.etherscan.io/token/0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14"
+  },
+  [Chains.BaseMainnet]: {
+    address: "0x4200000000000000000000000000000000000006",
+    decimals: 18,
+    name: "Wrapped Ether",
+    explorer: "https://basescan.org/token/0x4200000000000000000000000000000000000006"
+  },
+  [Chains.BaseSepolia]: {
+    address: "0x4200000000000000000000000000000000000006",
+    decimals: 18,
+    name: "Wrapped Ether (Base Sepolia)",
+    explorer: "https://sepolia.basescan.org/token/0x4200000000000000000000000000000000000006"
+  }
+};
+var DAI = {
+  [Chains.EthereumMainnet]: {
+    address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
+    decimals: 18,
+    name: "Dai Stablecoin",
+    description: "Decentralized USD-pegged stablecoin issued by MakerDAO.",
+    website: "https://makerdao.com",
+    explorer: "https://etherscan.io/token/0x6B175474E89094C44Da98b954EedeAC495271d0F",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/DAI.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/dai",
+      coinmarketcap: "https://coinmarketcap.com/currencies/multi-collateral-dai/"
+    }
+  },
+  [Chains.BaseMainnet]: {
+    address: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
+    decimals: 18,
+    name: "Dai Stablecoin",
+    explorer: "https://basescan.org/token/0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb"
+  }
+};
+var LINK = {
+  [Chains.EthereumMainnet]: {
+    address: "0x514910771AF9Ca656af840dff83E8264EcF986CA",
+    decimals: 18,
+    name: "ChainLink Token",
+    description: "Native token of the Chainlink decentralized oracle network.",
+    website: "https://chain.link",
+    explorer: "https://etherscan.io/token/0x514910771AF9Ca656af840dff83E8264EcF986CA",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/LINK.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/chainlink",
+      coinmarketcap: "https://coinmarketcap.com/currencies/chainlink/"
+    }
+  },
+  [Chains.Sepolia]: {
+    // AAVE V3 faucet-mintable LINK on Sepolia — NOT canonical Chainlink LINK.
+    // Templates targeting the AAVE Sepolia market need this address; the real
+    // Chainlink LINK on Sepolia is at 0x779877A7B0D9E8603169DdbD7836e478b4624789.
+    address: "0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5",
+    decimals: 18,
+    name: "ChainLink Token (AAVE Sepolia faucet)",
+    explorer: "https://sepolia.etherscan.io/token/0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5"
+  }
+};
+var Tokens = Object.freeze({
+  USDC,
+  USDT,
+  WETH,
+  DAI,
+  LINK
+});
+function lookupToken(chainId, address) {
+  if (!address) return void 0;
+  const target = address.toLowerCase();
+  if (chainId) {
+    for (const [symbol, byChain] of Object.entries(Tokens)) {
+      const entry = byChain[chainId];
+      if (entry && entry.address.toLowerCase() === target) {
+        return { symbol, ...entry };
+      }
+    }
+  }
+  for (const [symbol, byChain] of Object.entries(Tokens)) {
+    for (const entry of Object.values(byChain)) {
+      if (entry && entry.address.toLowerCase() === target) {
+        return { symbol, ...entry };
+      }
+    }
+  }
+  return void 0;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Chains,
   Protocols,
+  Tokens,
   aaveV3,
   aerodrome,
   aggregatorV3Abi,
@@ -838,6 +1026,7 @@ var Protocols = Object.freeze({
   ethena,
   fraxEther,
   lido,
+  lookupToken,
   morphoBlue,
   rocketPool,
   sky,

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./protocols";
 export { Chains, type ChainId } from "./chains";
+export { Tokens, lookupToken } from "./tokens";
+export type { TokenByChain, TokenChainEntry, TokenLinks } from "./tokens";
 //# 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,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -4,7 +4,8 @@ var Chains = Object.freeze({
   Sepolia: 11155111,
   Holesky: 17e3,
   BaseMainnet: 8453,
-  BaseSepolia: 84532
+  BaseSepolia: 84532,
+  BnbMainnet: 56
 });
 
 // src/protocols/aave-v3.ts
@@ -12,13 +13,15 @@ var pool = {
   [Chains.EthereumMainnet]: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
   [Chains.Sepolia]: "0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951",
   [Chains.BaseMainnet]: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
-  [Chains.BaseSepolia]: "0x8bAB6d1b75f19e9eD9fCe8b9BD338844fF79aE27"
+  [Chains.BaseSepolia]: "0x8bAB6d1b75f19e9eD9fCe8b9BD338844fF79aE27",
+  [Chains.BnbMainnet]: "0x6807dc923806fE8Fd134338EABCA509979a7e0cB"
 };
 var oracle = {
   [Chains.EthereumMainnet]: "0x54586bE62E3c3580375aE3723C145253060Ca0C2",
   [Chains.Sepolia]: "0x2da88497588bf89281816106C7259e31AF45a663",
   [Chains.BaseMainnet]: "0x2Cc0Fc26eD4563A5ce5e8bdcfe1A2878676Ae156",
-  [Chains.BaseSepolia]: "0x943b0dE18d4abf4eF02A85912F8fc07684C141dF"
+  [Chains.BaseSepolia]: "0x943b0dE18d4abf4eF02A85912F8fc07684C141dF",
+  [Chains.BnbMainnet]: "0x39bc1bfDa2130d6Bb6DBEfd366939b4c7aa7C697"
 };
 var wethGateway = {
   [Chains.EthereumMainnet]: "0xd01607c3C5eCABa394D8be377a08590149325722",
@@ -259,14 +262,20 @@ var erc4626VaultAbi = Object.freeze([
 // src/protocols/chainlink.ts
 var ethUsdFeed = {
   [Chains.EthereumMainnet]: "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
-  [Chains.Sepolia]: "0x694AA1769357215DE4FAC081bf1f309aDC325306"
+  [Chains.Sepolia]: "0x694AA1769357215DE4FAC081bf1f309aDC325306",
+  [Chains.BnbMainnet]: "0x9ef1B8c0E4F7dc8bF5719Ea496883DC6401d5b2e"
 };
 var btcUsdFeed = {
-  [Chains.EthereumMainnet]: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c"
+  [Chains.EthereumMainnet]: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c",
+  [Chains.BnbMainnet]: "0x264990fbd0A4796A3E3d8E37C4d5F87a3aCa5Ebf"
+};
+var bnbUsdFeed = {
+  [Chains.BnbMainnet]: "0x0567F2323251f0Aab15c8dFb1967E4e8A7D42aeE"
 };
 var chainlink = Object.freeze({
   ethUsdFeed,
   btcUsdFeed,
+  bnbUsdFeed,
   /** Shared AggregatorV3 ABI — works for any Chainlink feed. */
   aggregatorV3Abi
 });
@@ -534,7 +543,8 @@ var spark = Object.freeze({
 // src/protocols/superfluid.ts
 var cfaForwarder = {
   [Chains.EthereumMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125",
-  [Chains.BaseMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125"
+  [Chains.BaseMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125",
+  [Chains.BnbMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125"
 };
 var cfaForwarderAbi = Object.freeze([
   {
@@ -572,37 +582,43 @@ var swapRouter02 = {
   [Chains.EthereumMainnet]: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
   [Chains.Sepolia]: "0x3bFA4769FB09eefC5a80d6E87c3B9C650f7Ae48E",
   [Chains.BaseMainnet]: "0x2626664c2603336E57B271c5C0b26F421741e481",
-  [Chains.BaseSepolia]: "0x94cC0AaC535CCDB3C01d6787D6413C739ae12bc4"
+  [Chains.BaseSepolia]: "0x94cC0AaC535CCDB3C01d6787D6413C739ae12bc4",
+  [Chains.BnbMainnet]: "0xB971eF87ede563556b2ED4b1C0b0019111Dd85d2"
 };
 var quoterV2 = {
   [Chains.EthereumMainnet]: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e",
   [Chains.Sepolia]: "0xEd1f6473345F45b75F8179591dd5bA1888cf2FB3",
   [Chains.BaseMainnet]: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a",
-  [Chains.BaseSepolia]: "0xC5290058841028F1614F3A6F0F5816cAd0df5E27"
+  [Chains.BaseSepolia]: "0xC5290058841028F1614F3A6F0F5816cAd0df5E27",
+  [Chains.BnbMainnet]: "0x78D78E420Da98ad378D7799bE8f4AF69033EB077"
 };
 var permit2 = {
   [Chains.EthereumMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
   [Chains.Sepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
   [Chains.BaseMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
-  [Chains.BaseSepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3"
+  [Chains.BaseSepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
+  [Chains.BnbMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3"
 };
 var factory = {
   [Chains.EthereumMainnet]: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
   [Chains.Sepolia]: "0x0227628f3F023bb0B980b67D528571c95c6DaC1c",
   [Chains.BaseMainnet]: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD",
-  [Chains.BaseSepolia]: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24"
+  [Chains.BaseSepolia]: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24",
+  [Chains.BnbMainnet]: "0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7"
 };
 var nonfungiblePositionManager = {
   [Chains.EthereumMainnet]: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
   [Chains.Sepolia]: "0x1238536071E1c677A632429e3655c799b22cDA52",
   [Chains.BaseMainnet]: "0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1",
-  [Chains.BaseSepolia]: "0x27F971cb582BF9E50F397e4d29a5C7A34f11faA2"
+  [Chains.BaseSepolia]: "0x27F971cb582BF9E50F397e4d29a5C7A34f11faA2",
+  [Chains.BnbMainnet]: "0x7b8A01B39D58278b5DE7e48c8449c9f4F5170613"
 };
 var universalRouter = {
   [Chains.EthereumMainnet]: "0x66a9893cc07d91d95644aedd05d03f95e1dba8af",
   [Chains.Sepolia]: "0x3A9D48AB9751398BbFa63ad67599Bb04e4BdF98b",
   [Chains.BaseMainnet]: "0x6ff5693b99212da76ad316178a184ab56d299b43",
-  [Chains.BaseSepolia]: "0x492e6456d9528771018deb9e87ef7750ef184104"
+  [Chains.BaseSepolia]: "0x492e6456d9528771018deb9e87ef7750ef184104",
+  [Chains.BnbMainnet]: "0x4Dae2f939ACf50408e13d58534Ff8c2776d45265"
 };
 var swapRouter02Abi = Object.freeze([
   {
@@ -695,13 +711,15 @@ var tokens2 = Object.freeze({
     [Chains.Sepolia]: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
     [Chains.EthereumMainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
     [Chains.BaseMainnet]: "0x4200000000000000000000000000000000000006",
-    [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006"
+    [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006",
+    [Chains.BnbMainnet]: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
   },
   USDC: {
     [Chains.Sepolia]: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
     [Chains.EthereumMainnet]: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
     [Chains.BaseMainnet]: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-    [Chains.BaseSepolia]: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+    [Chains.BaseSepolia]: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    [Chains.BnbMainnet]: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"
   }
 });
 var uniswapV3 = Object.freeze({
@@ -722,7 +740,9 @@ var weth = {
   [Chains.EthereumMainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
   [Chains.Sepolia]: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
   [Chains.BaseMainnet]: "0x4200000000000000000000000000000000000006",
-  [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006"
+  [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006",
+  // BNB Chain's native is BNB, not ETH — this entry is WBNB.
+  [Chains.BnbMainnet]: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
 };
 var wethAbi = Object.freeze([
   {
@@ -780,9 +800,175 @@ var Protocols = Object.freeze({
   uniswapV3,
   wrapped
 });
+
+// src/tokens/index.ts
+var USDC = {
+  [Chains.EthereumMainnet]: {
+    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    decimals: 6,
+    name: "USD Coin",
+    description: "Fully-reserved USD stablecoin issued by Circle.",
+    website: "https://www.circle.com/usdc",
+    explorer: "https://etherscan.io/token/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/USDC.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/usd-coin",
+      coinmarketcap: "https://coinmarketcap.com/currencies/usd-coin/"
+    }
+  },
+  [Chains.BaseMainnet]: {
+    address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    decimals: 6,
+    name: "USD Coin",
+    explorer: "https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  },
+  [Chains.Sepolia]: {
+    address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    decimals: 6,
+    name: "USD Coin (Sepolia)",
+    explorer: "https://sepolia.etherscan.io/token/0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
+  },
+  [Chains.BaseSepolia]: {
+    address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    decimals: 6,
+    name: "USD Coin (Base Sepolia)",
+    explorer: "https://sepolia.basescan.org/token/0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+  },
+  [Chains.BnbMainnet]: {
+    address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+    decimals: 18,
+    name: "Binance-Peg USD Coin",
+    explorer: "https://bscscan.com/token/0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"
+  }
+};
+var USDT = {
+  [Chains.EthereumMainnet]: {
+    address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+    decimals: 6,
+    name: "Tether USD",
+    description: "USD-pegged stablecoin issued by Tether.",
+    website: "https://tether.to",
+    explorer: "https://etherscan.io/token/0xdAC17F958D2ee523a2206206994597C13D831ec7",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/USDT.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/tether",
+      coinmarketcap: "https://coinmarketcap.com/currencies/tether/"
+    }
+  },
+  [Chains.BnbMainnet]: {
+    address: "0x55d398326f99059fF775485246999027B3197955",
+    decimals: 18,
+    name: "Binance-Peg Tether USD",
+    explorer: "https://bscscan.com/token/0x55d398326f99059fF775485246999027B3197955"
+  }
+};
+var WETH = {
+  [Chains.EthereumMainnet]: {
+    address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+    decimals: 18,
+    name: "Wrapped Ether",
+    description: "ERC-20 wrapper around native ETH, 1:1 backed.",
+    explorer: "https://etherscan.io/token/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/WETH.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/weth"
+    }
+  },
+  [Chains.Sepolia]: {
+    address: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
+    decimals: 18,
+    name: "Wrapped Ether (Sepolia)",
+    explorer: "https://sepolia.etherscan.io/token/0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14"
+  },
+  [Chains.BaseMainnet]: {
+    address: "0x4200000000000000000000000000000000000006",
+    decimals: 18,
+    name: "Wrapped Ether",
+    explorer: "https://basescan.org/token/0x4200000000000000000000000000000000000006"
+  },
+  [Chains.BaseSepolia]: {
+    address: "0x4200000000000000000000000000000000000006",
+    decimals: 18,
+    name: "Wrapped Ether (Base Sepolia)",
+    explorer: "https://sepolia.basescan.org/token/0x4200000000000000000000000000000000000006"
+  }
+};
+var DAI = {
+  [Chains.EthereumMainnet]: {
+    address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
+    decimals: 18,
+    name: "Dai Stablecoin",
+    description: "Decentralized USD-pegged stablecoin issued by MakerDAO.",
+    website: "https://makerdao.com",
+    explorer: "https://etherscan.io/token/0x6B175474E89094C44Da98b954EedeAC495271d0F",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/DAI.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/dai",
+      coinmarketcap: "https://coinmarketcap.com/currencies/multi-collateral-dai/"
+    }
+  },
+  [Chains.BaseMainnet]: {
+    address: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
+    decimals: 18,
+    name: "Dai Stablecoin",
+    explorer: "https://basescan.org/token/0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb"
+  }
+};
+var LINK = {
+  [Chains.EthereumMainnet]: {
+    address: "0x514910771AF9Ca656af840dff83E8264EcF986CA",
+    decimals: 18,
+    name: "ChainLink Token",
+    description: "Native token of the Chainlink decentralized oracle network.",
+    website: "https://chain.link",
+    explorer: "https://etherscan.io/token/0x514910771AF9Ca656af840dff83E8264EcF986CA",
+    logoUrl: "https://raw.githubusercontent.com/AvaProtocol/protocols/main/logos/ethereum/LINK.png",
+    links: {
+      coingecko: "https://www.coingecko.com/en/coins/chainlink",
+      coinmarketcap: "https://coinmarketcap.com/currencies/chainlink/"
+    }
+  },
+  [Chains.Sepolia]: {
+    // AAVE V3 faucet-mintable LINK on Sepolia — NOT canonical Chainlink LINK.
+    // Templates targeting the AAVE Sepolia market need this address; the real
+    // Chainlink LINK on Sepolia is at 0x779877A7B0D9E8603169DdbD7836e478b4624789.
+    address: "0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5",
+    decimals: 18,
+    name: "ChainLink Token (AAVE Sepolia faucet)",
+    explorer: "https://sepolia.etherscan.io/token/0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5"
+  }
+};
+var Tokens = Object.freeze({
+  USDC,
+  USDT,
+  WETH,
+  DAI,
+  LINK
+});
+function lookupToken(chainId, address) {
+  if (!address) return void 0;
+  const target = address.toLowerCase();
+  if (chainId) {
+    for (const [symbol, byChain] of Object.entries(Tokens)) {
+      const entry = byChain[chainId];
+      if (entry && entry.address.toLowerCase() === target) {
+        return { symbol, ...entry };
+      }
+    }
+  }
+  for (const [symbol, byChain] of Object.entries(Tokens)) {
+    for (const entry of Object.values(byChain)) {
+      if (entry && entry.address.toLowerCase() === target) {
+        return { symbol, ...entry };
+      }
+    }
+  }
+  return void 0;
+}
 export {
   Chains,
   Protocols,
+  Tokens,
   aaveV3,
   aerodrome,
   aggregatorV3Abi,
@@ -793,6 +979,7 @@ export {
   ethena,
   fraxEther,
   lido,
+  lookupToken,
   morphoBlue,
   rocketPool,
   sky,

package/dist/protocols/aave-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aave-v3.d.ts","sourceRoot":"","sources":["../../src/protocols/aave-v3.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AA2NhE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;EAQjB,CAAC"}
+{"version":3,"file":"aave-v3.d.ts","sourceRoot":"","sources":["../../src/protocols/aave-v3.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAiOhE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;EAQjB,CAAC"}

package/dist/protocols/chainlink.d.ts

@@ -1,6 +1,7 @@
 export declare const chainlink: Readonly<{
     ethUsdFeed: Partial<Record<number, `0x${string}`>>;
     btcUsdFeed: Partial<Record<number, `0x${string}`>>;
+    bnbUsdFeed: Partial<Record<number, `0x${string}`>>;
     /** Shared AggregatorV3 ABI — works for any Chainlink feed. */
     aggregatorV3Abi: readonly import("./types").AbiFragment[];
 }>;

package/dist/protocols/chainlink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chainlink.d.ts","sourceRoot":"","sources":["../../src/protocols/chainlink.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,SAAS;;;IAGpB,8DAA8D;;EAE9D,CAAC"}
+{"version":3,"file":"chainlink.d.ts","sourceRoot":"","sources":["../../src/protocols/chainlink.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,SAAS;;;;IAIpB,8DAA8D;;EAE9D,CAAC"}

package/dist/protocols/index.d.ts

@@ -58,6 +58,7 @@ export declare const Protocols: Readonly<{
     chainlink: Readonly<{
         ethUsdFeed: Partial<Record<number, `0x${string}`>>;
         btcUsdFeed: Partial<Record<number, `0x${string}`>>;
+        bnbUsdFeed: Partial<Record<number, `0x${string}`>>;
         aggregatorV3Abi: readonly import("./types").AbiFragment[];
     }>;
     compoundV3: Readonly<{
@@ -116,12 +117,14 @@ export declare const Protocols: Readonly<{
                 1: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
                 8453: "0x4200000000000000000000000000000000000006";
                 84532: "0x4200000000000000000000000000000000000006";
+                56: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
             };
             USDC: {
                 11155111: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238";
                 1: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
                 8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
                 84532: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+                56: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
             };
         }>;
     }>;

package/dist/protocols/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocols/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAkB3D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocols/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAkB3D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBpB,CAAC"}

package/dist/protocols/superfluid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"superfluid.d.ts","sourceRoot":"","sources":["../../src/protocols/superfluid.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAmChE,eAAO,MAAM,UAAU;;;EAGrB,CAAC"}
+{"version":3,"file":"superfluid.d.ts","sourceRoot":"","sources":["../../src/protocols/superfluid.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAoChE,eAAO,MAAM,UAAU;;;EAGrB,CAAC"}

package/dist/protocols/uniswap-v3.d.ts

@@ -15,12 +15,14 @@ export declare const uniswapV3: Readonly<{
             1: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
             8453: "0x4200000000000000000000000000000000000006";
             84532: "0x4200000000000000000000000000000000000006";
+            56: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
         };
         USDC: {
             11155111: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238";
             1: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
             8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
             84532: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+            56: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
         };
     }>;
 }>;

package/dist/protocols/uniswap-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uniswap-v3.d.ts","sourceRoot":"","sources":["../../src/protocols/uniswap-v3.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAsLhE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;EAWpB,CAAC"}
+{"version":3,"file":"uniswap-v3.d.ts","sourceRoot":"","sources":["../../src/protocols/uniswap-v3.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAsMhE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAWpB,CAAC"}

package/dist/protocols/wrapped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapped.d.ts","sourceRoot":"","sources":["../../src/protocols/wrapped.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAkDhE,eAAO,MAAM,OAAO;;;EAGlB,CAAC"}
+{"version":3,"file":"wrapped.d.ts","sourceRoot":"","sources":["../../src/protocols/wrapped.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAoDhE,eAAO,MAAM,OAAO;;;EAGlB,CAAC"}

package/dist/tokens/base-sepolia.json

@@ -0,0 +1,14 @@
+[
+  {
+    "id": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
+    "name": "USD Coin (Base Sepolia)",
+    "symbol": "USDC",
+    "decimals": 6
+  },
+  {
+    "id": "0x4200000000000000000000000000000000000006",
+    "name": "Wrapped Ether (Base Sepolia)",
+    "symbol": "WETH",
+    "decimals": 18
+  }
+]

package/dist/tokens/base.json

@@ -0,0 +1,20 @@
+[
+  {
+    "id": "0x50c5725949a6f0c72e6c4a641f24049a917db0cb",
+    "name": "Dai Stablecoin",
+    "symbol": "DAI",
+    "decimals": 18
+  },
+  {
+    "id": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+    "name": "USD Coin",
+    "symbol": "USDC",
+    "decimals": 6
+  },
+  {
+    "id": "0x4200000000000000000000000000000000000006",
+    "name": "Wrapped Ether",
+    "symbol": "WETH",
+    "decimals": 18
+  }
+]

package/dist/tokens/bnb-mainnet.json

@@ -0,0 +1,14 @@
+[
+  {
+    "id": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
+    "name": "Binance-Peg USD Coin",
+    "symbol": "USDC",
+    "decimals": 18
+  },
+  {
+    "id": "0x55d398326f99059ff775485246999027b3197955",
+    "name": "Binance-Peg Tether USD",
+    "symbol": "USDT",
+    "decimals": 18
+  }
+]

package/dist/tokens/ethereum.json

@@ -0,0 +1,32 @@
+[
+  {
+    "id": "0x6b175474e89094c44da98b954eedeac495271d0f",
+    "name": "Dai Stablecoin",
+    "symbol": "DAI",
+    "decimals": 18
+  },
+  {
+    "id": "0x514910771af9ca656af840dff83e8264ecf986ca",
+    "name": "ChainLink Token",
+    "symbol": "LINK",
+    "decimals": 18
+  },
+  {
+    "id": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+    "name": "USD Coin",
+    "symbol": "USDC",
+    "decimals": 6
+  },
+  {
+    "id": "0xdac17f958d2ee523a2206206994597c13d831ec7",
+    "name": "Tether USD",
+    "symbol": "USDT",
+    "decimals": 6
+  },
+  {
+    "id": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
+    "name": "Wrapped Ether",
+    "symbol": "WETH",
+    "decimals": 18
+  }
+]

package/dist/tokens/index.d.ts

@@ -0,0 +1,53 @@
+import { type TokenChainEntry } from "./types";
+export type { TokenByChain, TokenChainEntry, TokenLinks } from "./types";
+/**
+ * Symbol → per-chain entry. The outer object is frozen at module
+ * load, so the symbol set is immutable. The inner per-chain maps
+ * (e.g. `Tokens.USDC`) are NOT deep-frozen — callers must treat
+ * them as logically read-only. The shallow freeze is the right
+ * tradeoff: deep-freezing the chain maps + their entries on every
+ * import would add overhead for a guarantee no consumer has asked
+ * for. Add a deep-freeze pass here if a real misuse case emerges.
+ *
+ * Symbol keys are the canonical uppercase ERC-20 ticker (USDC, not
+ * usdc/Usdc). The catalog is intentionally not case-insensitive at
+ * this level — callers needing a fuzzy lookup should normalize at
+ * their own boundary.
+ */
+export declare const Tokens: Readonly<{
+    USDC: Partial<Record<number, TokenChainEntry>>;
+    USDT: Partial<Record<number, TokenChainEntry>>;
+    WETH: Partial<Record<number, TokenChainEntry>>;
+    DAI: Partial<Record<number, TokenChainEntry>>;
+    LINK: Partial<Record<number, TokenChainEntry>>;
+}>;
+/**
+ * Reverse lookup: given a contract address, find the token entry plus
+ * its symbol. Address matching is case-insensitive so callers can pass
+ * checksum or lowercase without normalizing upstream.
+ *
+ * Resolution strategy:
+ *   1. When `chainId` is provided, prefer a match registered for that
+ *      chain.
+ *   2. If no chain-specific match (or no chainId), scan every chain
+ *      for the address. Necessary when the caller's chain context
+ *      diverges from where the address actually lives — happens in
+ *      multi-chain dev gateways where the workflow targets one chain
+ *      but the runtime is bound to a different one. Most ERC-20
+ *      addresses are globally unique so this collapses to a single
+ *      match; for OP-stack predeploys (e.g. WETH at 0x4200…0006 on
+ *      both Base and Base Sepolia), any match yields the correct
+ *      symbol and decimals.
+ *
+ * Returns `undefined` when no chain in the catalog carries the
+ * address, or when the address is missing/falsy.
+ *
+ * Typical use: aggregator payloads ship `tokenSymbol="UNKNOWN"` for
+ * tokens whose chain-specific RPC enrichment failed; consumers fall
+ * through to `lookupToken(chainId, contractAddress)` and recover the
+ * symbol + decimals from this catalog.
+ */
+export declare function lookupToken(chainId: number | undefined, address: string | undefined): (TokenChainEntry & {
+    symbol: string;
+}) | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA+IzE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM;;;;;;EAMgC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,CAAC,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAsBpD"}

package/dist/tokens/sepolia.json

@@ -0,0 +1,20 @@
+[
+  {
+    "id": "0xf8fb3713d459d7c1018bd0a49d19b4c44290ebe5",
+    "name": "ChainLink Token (AAVE Sepolia faucet)",
+    "symbol": "LINK",
+    "decimals": 18
+  },
+  {
+    "id": "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238",
+    "name": "USD Coin (Sepolia)",
+    "symbol": "USDC",
+    "decimals": 6
+  },
+  {
+    "id": "0xfff9976782d46cc05630d1f6ebab18b2324d6b14",
+    "name": "Wrapped Ether (Sepolia)",
+    "symbol": "WETH",
+    "decimals": 18
+  }
+]

package/dist/tokens/types.d.ts

@@ -0,0 +1,47 @@
+import { type ChainId } from "../chains";
+/**
+ * External reference links for a token. All fields optional — the
+ * catalog only records what's actually known per token. Add new keys
+ * here when adding a category we want to surface; consumers ignore
+ * unknown keys harmlessly.
+ */
+export interface TokenLinks {
+    readonly github?: string;
+    readonly twitter?: string;
+    readonly coingecko?: string;
+    readonly coinmarketcap?: string;
+    readonly reddit?: string;
+    readonly blog?: string;
+    readonly whitepaper?: string;
+}
+/**
+ * Per-chain token deployment record. `address` and `decimals` are
+ * required because they're the universal lookup primitives every
+ * consumer needs. All other fields are optional metadata.
+ *
+ * `name` is per-chain because some tokens use different display names
+ * on different deployments (e.g. AAVE's faucet-LINK on Sepolia is
+ * "ChainLink Token" vs. "Chainlink" on mainnet). When the chains
+ * agree, the same string is fine to repeat.
+ *
+ * `logoUrl` is a fully qualified URL — typically a GitHub Raw or CDN
+ * link. Studio renders local PNGs by resolving symbol+chain itself
+ * and ignores this field; backend consumers may surface the URL
+ * directly in summaries or skip it.
+ */
+export interface TokenChainEntry {
+    readonly address: `0x${string}`;
+    readonly decimals: number;
+    readonly name?: string;
+    readonly description?: string;
+    readonly website?: string;
+    readonly explorer?: string;
+    readonly logoUrl?: string;
+    readonly links?: TokenLinks;
+}
+/**
+ * Map of `ChainId → TokenChainEntry`. `Partial` because no token is
+ * deployed on every chain in the catalog.
+ */
+export type TokenByChain = Partial<Record<ChainId, TokenChainEntry>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tokens/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tokens/types.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avaprotocol/protocols",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Multi-chain catalog of DeFi protocol contract addresses, ABI fragments, and event topic hashes — covers AAVE V3, Uniswap V3, Chainlink, Lido, Morpho, and more.",
   "keywords": [
     "defi",
@@ -50,17 +50,23 @@
   "scripts": {
     "build:declarations": "tsc -p tsconfig.build.json",
     "build:js": "tsup src/index.ts --format cjs,esm --target es2020",
-    "build": "yarn clean:dist && yarn build:declarations && yarn build:js",
+    "build:tokens-sidecar": "tsx scripts/build-tokens-sidecar.ts",
+    "build": "yarn clean:dist && yarn build:declarations && yarn build:js && yarn build:tokens-sidecar",
     "clean": "rm -rf node_modules dist tsconfig.tsbuildinfo",
     "clean:dist": "rm -rf dist tsconfig.tsbuildinfo",
     "test": "vitest",
     "test:run": "vitest run",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
-    "prepublishOnly": "yarn build"
+    "prepublishOnly": "yarn build",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "yarn build && changeset publish"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.31.0",
     "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
     "typescript": "^5.5.4",
     "vitest": "^1.6.0"
   },