@parallel-protocol/chains 0.1.0 → 0.2.0

package/README.md

@@ -55,6 +55,26 @@ ABIs are exposed under the `/abi` subpath:
 import { PARALLELIZER_ABI, ERC20_ABI } from "@parallel-protocol/chains/abi";
 ```
 
+## Payment tokens
+
+`getTokenDecimals` is the single source of truth for the decimals of every
+Parallel payment token — USDp, sUSDp, USDC and the Parallelizer backing
+collaterals — so merchant and payer sides price amounts identically:
+
+```ts
+import { getTokenDecimals, COLLATERAL_TOKENS } from "@parallel-protocol/chains";
+
+getTokenDecimals("base", "0x76A9A0062ec…"); // 18  (USDp)
+getTokenDecimals("base", "0x833589fCD6…"); // 6   (USDC)
+getTokenDecimals("base", "0x820C137fa7…"); // 18  (USDS, a backing collateral)
+getTokenDecimals("base", "0xdead…");       // undefined — outside the catalogue
+
+COLLATERAL_TOKENS.base; // { "0x820c…": { symbol: "USDS", decimals: 18 }, … }
+```
+
+Values are verified on-chain and immutable per token; `undefined` lets callers
+decide their own fallback for tokens outside the catalogue.
+
 ## Composing your RPC layer
 
 Pass `.viem` straight to `createPublicClient` — RPC URLs are intentionally

package/dist/abi.cjs

@@ -2006,6 +2006,28 @@ var SUSDP_ABI = [
       { name: "s", type: "bytes32" }
     ],
     outputs: []
+  },
+  // ERC-4626 events
+  {
+    name: "Deposit",
+    type: "event",
+    inputs: [
+      { name: "caller", type: "address", indexed: true },
+      { name: "owner", type: "address", indexed: true },
+      { name: "assets", type: "uint256", indexed: false },
+      { name: "shares", type: "uint256", indexed: false }
+    ]
+  },
+  {
+    name: "Withdraw",
+    type: "event",
+    inputs: [
+      { name: "caller", type: "address", indexed: true },
+      { name: "receiver", type: "address", indexed: true },
+      { name: "owner", type: "address", indexed: true },
+      { name: "assets", type: "uint256", indexed: false },
+      { name: "shares", type: "uint256", indexed: false }
+    ]
   }
 ];
 

package/dist/abi.d.cts

@@ -3413,6 +3413,50 @@ declare const SUSDP_ABI: readonly [{
         readonly type: "bytes32";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly name: "Deposit";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "assets";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "Withdraw";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "assets";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
 }];
 
 declare const USDC_EIP3009_ABI: readonly [{

package/dist/abi.d.ts

@@ -3413,6 +3413,50 @@ declare const SUSDP_ABI: readonly [{
         readonly type: "bytes32";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly name: "Deposit";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "assets";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "Withdraw";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "assets";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
 }];
 
 declare const USDC_EIP3009_ABI: readonly [{

package/dist/abi.js

@@ -2004,6 +2004,28 @@ var SUSDP_ABI = [
       { name: "s", type: "bytes32" }
     ],
     outputs: []
+  },
+  // ERC-4626 events
+  {
+    name: "Deposit",
+    type: "event",
+    inputs: [
+      { name: "caller", type: "address", indexed: true },
+      { name: "owner", type: "address", indexed: true },
+      { name: "assets", type: "uint256", indexed: false },
+      { name: "shares", type: "uint256", indexed: false }
+    ]
+  },
+  {
+    name: "Withdraw",
+    type: "event",
+    inputs: [
+      { name: "caller", type: "address", indexed: true },
+      { name: "receiver", type: "address", indexed: true },
+      { name: "owner", type: "address", indexed: true },
+      { name: "assets", type: "uint256", indexed: false },
+      { name: "shares", type: "uint256", indexed: false }
+    ]
   }
 ];
 

package/dist/index.cjs

@@ -392,10 +392,70 @@ function getMulticall3Address(chainName) {
   return cfg?.viem.contracts?.multicall3?.address;
 }
 
+// src/tokens.ts
+var USDC_BASE = USDC_CHAIN_ADDRESSES.base;
+var USDC_AVALANCHE = USDC_CHAIN_ADDRESSES.avalanche;
+var COLLATERAL_TOKENS = {
+  ethereum: {
+    "0xcacd6fd266af91b8aed52accc382b4e165586e29": {
+      symbol: "frxUSD",
+      decimals: 18
+    },
+    "0xcf62f905562626cfcdd2261162a51fd02fc9c5b6": {
+      symbol: "sfrxUSD",
+      decimals: 18
+    },
+    "0x4c9edd5852cd905f086c759e8383e09bff1e68b3": {
+      symbol: "USDe",
+      decimals: 18
+    },
+    "0x9d39a5de30e57443bff2a8307a4256c8797a3497": {
+      symbol: "sUSDe",
+      decimals: 18
+    }
+  },
+  base: {
+    "0x820c137fa70c8691f0e44dc420a5e53c168921dc": {
+      symbol: "USDS",
+      decimals: 18
+    },
+    "0x5875eee11cf8398102fdad704c9e96607675467a": {
+      symbol: "sUSDS",
+      decimals: 18
+    },
+    [USDC_BASE.toLowerCase()]: { symbol: "USDC", decimals: 6 }
+  },
+  avalanche: {
+    "0x9fd32fd5e32c6b95483d36c5e724c5c5250ce010": {
+      symbol: "ygamiUSDC",
+      decimals: 6
+    },
+    [USDC_AVALANCHE.toLowerCase()]: { symbol: "USDC", decimals: 6 }
+  },
+  hyperevm: {
+    "0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34": {
+      symbol: "USDe",
+      decimals: 18
+    },
+    "0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2": {
+      symbol: "sUSDe",
+      decimals: 18
+    }
+  }
+};
+function getTokenDecimals(chainName, address) {
+  const lower = address.toLowerCase();
+  if (getUSDpAddress(chainName)?.toLowerCase() === lower) return 18;
+  if (getSUSDpAddress(chainName)?.toLowerCase() === lower) return 18;
+  if (getUSDCAddress(chainName)?.toLowerCase() === lower) return 6;
+  return COLLATERAL_TOKENS[chainName]?.[lower]?.decimals;
+}
+
 exports.ACTIVE_CHAINS = ACTIVE_CHAINS;
 exports.BPT_POOL_ID = BPT_POOL_ID;
 exports.CHAINS_STATIC = CHAINS_STATIC;
 exports.CHAIN_NAMES = CHAIN_NAMES;
+exports.COLLATERAL_TOKENS = COLLATERAL_TOKENS;
 exports.ChainEnum = ChainEnum;
 exports.PARALLELIZER_CHAINS = PARALLELIZER_CHAINS;
 exports.PRL_ADDRESS = PRL_ADDRESS;
@@ -411,6 +471,7 @@ exports.getChainId = getChainId;
 exports.getMulticall3Address = getMulticall3Address;
 exports.getParallelizerAddress = getParallelizerAddress;
 exports.getSUSDpAddress = getSUSDpAddress;
+exports.getTokenDecimals = getTokenDecimals;
 exports.getUSDCAddress = getUSDCAddress;
 exports.getUSDpAddress = getUSDpAddress;
 exports.isKnownChain = isKnownChain;

package/dist/index.d.cts

@@ -101,4 +101,21 @@ declare function isKnownChain(chainName: string): chainName is Chain;
 /** Returns the canonical multicall3 address for a given chain, if available. */
 declare function getMulticall3Address(chainName: string): Address | undefined;
 
-export { ACTIVE_CHAINS, BPT_POOL_ID, CHAINS_STATIC, CHAIN_NAMES, type Chain, type ChainContracts, ChainEnum, type ChainStaticConfig, type ChainStatus, PARALLELIZER_CHAINS, PRL_ADDRESS, REWARD_MERKLE_DISTRIBUTOR_ADDRESS, SAVINGS_CHAINS, SPRL1_ADDRESS, SPRL1_CHAIN_ADDRESSES, SPRL2_ADDRESS, STAKING_CHAINS, USDC_CHAIN_ADDRESSES, WETH_ADDRESS, getChainId, getMulticall3Address, getParallelizerAddress, getSUSDpAddress, getUSDCAddress, getUSDpAddress, isKnownChain, isParallelizerChain };
+type TokenInfo = {
+    symbol: string;
+    decimals: number;
+};
+/**
+ * Parallelizer backing collaterals per chain — addresses and decimals verified
+ * on-chain (`getCollateralList`). Keys are lowercase addresses. USDp and sUSDp
+ * are protocol tokens, not collaterals; they resolve through the chain catalog.
+ */
+declare const COLLATERAL_TOKENS: Partial<Record<Chain, Record<string, TokenInfo>>>;
+/**
+ * Decimals of a known Parallel payment token (USDp, sUSDp, USDC or a backing
+ * collateral) by address. Returns `undefined` for tokens outside the catalog
+ * so callers can fall back explicitly.
+ */
+declare function getTokenDecimals(chainName: string, address: string): number | undefined;
+
+export { ACTIVE_CHAINS, BPT_POOL_ID, CHAINS_STATIC, CHAIN_NAMES, COLLATERAL_TOKENS, type Chain, type ChainContracts, ChainEnum, type ChainStaticConfig, type ChainStatus, PARALLELIZER_CHAINS, PRL_ADDRESS, REWARD_MERKLE_DISTRIBUTOR_ADDRESS, SAVINGS_CHAINS, SPRL1_ADDRESS, SPRL1_CHAIN_ADDRESSES, SPRL2_ADDRESS, STAKING_CHAINS, USDC_CHAIN_ADDRESSES, WETH_ADDRESS, getChainId, getMulticall3Address, getParallelizerAddress, getSUSDpAddress, getTokenDecimals, getUSDCAddress, getUSDpAddress, isKnownChain, isParallelizerChain };

package/dist/index.d.ts

@@ -101,4 +101,21 @@ declare function isKnownChain(chainName: string): chainName is Chain;
 /** Returns the canonical multicall3 address for a given chain, if available. */
 declare function getMulticall3Address(chainName: string): Address | undefined;
 
-export { ACTIVE_CHAINS, BPT_POOL_ID, CHAINS_STATIC, CHAIN_NAMES, type Chain, type ChainContracts, ChainEnum, type ChainStaticConfig, type ChainStatus, PARALLELIZER_CHAINS, PRL_ADDRESS, REWARD_MERKLE_DISTRIBUTOR_ADDRESS, SAVINGS_CHAINS, SPRL1_ADDRESS, SPRL1_CHAIN_ADDRESSES, SPRL2_ADDRESS, STAKING_CHAINS, USDC_CHAIN_ADDRESSES, WETH_ADDRESS, getChainId, getMulticall3Address, getParallelizerAddress, getSUSDpAddress, getUSDCAddress, getUSDpAddress, isKnownChain, isParallelizerChain };
+type TokenInfo = {
+    symbol: string;
+    decimals: number;
+};
+/**
+ * Parallelizer backing collaterals per chain — addresses and decimals verified
+ * on-chain (`getCollateralList`). Keys are lowercase addresses. USDp and sUSDp
+ * are protocol tokens, not collaterals; they resolve through the chain catalog.
+ */
+declare const COLLATERAL_TOKENS: Partial<Record<Chain, Record<string, TokenInfo>>>;
+/**
+ * Decimals of a known Parallel payment token (USDp, sUSDp, USDC or a backing
+ * collateral) by address. Returns `undefined` for tokens outside the catalog
+ * so callers can fall back explicitly.
+ */
+declare function getTokenDecimals(chainName: string, address: string): number | undefined;
+
+export { ACTIVE_CHAINS, BPT_POOL_ID, CHAINS_STATIC, CHAIN_NAMES, COLLATERAL_TOKENS, type Chain, type ChainContracts, ChainEnum, type ChainStaticConfig, type ChainStatus, PARALLELIZER_CHAINS, PRL_ADDRESS, REWARD_MERKLE_DISTRIBUTOR_ADDRESS, SAVINGS_CHAINS, SPRL1_ADDRESS, SPRL1_CHAIN_ADDRESSES, SPRL2_ADDRESS, STAKING_CHAINS, USDC_CHAIN_ADDRESSES, WETH_ADDRESS, getChainId, getMulticall3Address, getParallelizerAddress, getSUSDpAddress, getTokenDecimals, getUSDCAddress, getUSDpAddress, isKnownChain, isParallelizerChain };

package/dist/index.js

@@ -390,4 +390,63 @@ function getMulticall3Address(chainName) {
   return cfg?.viem.contracts?.multicall3?.address;
 }
 
-export { ACTIVE_CHAINS, BPT_POOL_ID, CHAINS_STATIC, CHAIN_NAMES, ChainEnum, PARALLELIZER_CHAINS, PRL_ADDRESS, REWARD_MERKLE_DISTRIBUTOR_ADDRESS, SAVINGS_CHAINS, SPRL1_ADDRESS, SPRL1_CHAIN_ADDRESSES, SPRL2_ADDRESS, STAKING_CHAINS, USDC_CHAIN_ADDRESSES, WETH_ADDRESS, getChainId, getMulticall3Address, getParallelizerAddress, getSUSDpAddress, getUSDCAddress, getUSDpAddress, isKnownChain, isParallelizerChain };
+// src/tokens.ts
+var USDC_BASE = USDC_CHAIN_ADDRESSES.base;
+var USDC_AVALANCHE = USDC_CHAIN_ADDRESSES.avalanche;
+var COLLATERAL_TOKENS = {
+  ethereum: {
+    "0xcacd6fd266af91b8aed52accc382b4e165586e29": {
+      symbol: "frxUSD",
+      decimals: 18
+    },
+    "0xcf62f905562626cfcdd2261162a51fd02fc9c5b6": {
+      symbol: "sfrxUSD",
+      decimals: 18
+    },
+    "0x4c9edd5852cd905f086c759e8383e09bff1e68b3": {
+      symbol: "USDe",
+      decimals: 18
+    },
+    "0x9d39a5de30e57443bff2a8307a4256c8797a3497": {
+      symbol: "sUSDe",
+      decimals: 18
+    }
+  },
+  base: {
+    "0x820c137fa70c8691f0e44dc420a5e53c168921dc": {
+      symbol: "USDS",
+      decimals: 18
+    },
+    "0x5875eee11cf8398102fdad704c9e96607675467a": {
+      symbol: "sUSDS",
+      decimals: 18
+    },
+    [USDC_BASE.toLowerCase()]: { symbol: "USDC", decimals: 6 }
+  },
+  avalanche: {
+    "0x9fd32fd5e32c6b95483d36c5e724c5c5250ce010": {
+      symbol: "ygamiUSDC",
+      decimals: 6
+    },
+    [USDC_AVALANCHE.toLowerCase()]: { symbol: "USDC", decimals: 6 }
+  },
+  hyperevm: {
+    "0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34": {
+      symbol: "USDe",
+      decimals: 18
+    },
+    "0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2": {
+      symbol: "sUSDe",
+      decimals: 18
+    }
+  }
+};
+function getTokenDecimals(chainName, address) {
+  const lower = address.toLowerCase();
+  if (getUSDpAddress(chainName)?.toLowerCase() === lower) return 18;
+  if (getSUSDpAddress(chainName)?.toLowerCase() === lower) return 18;
+  if (getUSDCAddress(chainName)?.toLowerCase() === lower) return 6;
+  return COLLATERAL_TOKENS[chainName]?.[lower]?.decimals;
+}
+
+export { ACTIVE_CHAINS, BPT_POOL_ID, CHAINS_STATIC, CHAIN_NAMES, COLLATERAL_TOKENS, ChainEnum, PARALLELIZER_CHAINS, PRL_ADDRESS, REWARD_MERKLE_DISTRIBUTOR_ADDRESS, SAVINGS_CHAINS, SPRL1_ADDRESS, SPRL1_CHAIN_ADDRESSES, SPRL2_ADDRESS, STAKING_CHAINS, USDC_CHAIN_ADDRESSES, WETH_ADDRESS, getChainId, getMulticall3Address, getParallelizerAddress, getSUSDpAddress, getTokenDecimals, getUSDCAddress, getUSDpAddress, isKnownChain, isParallelizerChain };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@parallel-protocol/chains",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "Parallel Protocol on-chain catalogue — chain ids, contract addresses, viem-typed ABIs",
 	"author": "Parallel Protocol <contact@parallel.best>",
 	"repository": "github:parallel-protocol/sdk-merchant",