@mento-protocol/mento-sdk 1.10.3 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +12 -17
  2. package/dist/cjs/constants/addresses.js +48 -32
  3. package/dist/cjs/constants/currencies.d.ts +5 -0
  4. package/dist/cjs/constants/currencies.js +29 -0
  5. package/dist/cjs/constants/index.d.ts +1 -0
  6. package/dist/cjs/constants/index.js +1 -0
  7. package/dist/cjs/constants/tradablePairs.11142220.d.ts +2 -0
  8. package/dist/cjs/constants/tradablePairs.11142220.js +7391 -0
  9. package/dist/cjs/constants/tradablePairs.42220.js +1 -1
  10. package/dist/cjs/constants/tradablePairs.44787.js +1 -1
  11. package/dist/cjs/constants/tradablePairs.js +2 -0
  12. package/dist/cjs/enums/chainId.d.ts +1 -0
  13. package/dist/cjs/enums/chainId.js +1 -0
  14. package/dist/cjs/mento.d.ts +20 -0
  15. package/dist/cjs/mento.js +45 -1
  16. package/dist/cjs/types/contractAddressMap.d.ts +1 -1
  17. package/dist/cjs/utils.d.ts +15 -6
  18. package/dist/cjs/utils.js +33 -22
  19. package/dist/esm/constants/addresses.js +48 -32
  20. package/dist/esm/constants/currencies.d.ts +5 -0
  21. package/dist/esm/constants/currencies.js +26 -0
  22. package/dist/esm/constants/index.d.ts +1 -0
  23. package/dist/esm/constants/index.js +1 -0
  24. package/dist/esm/constants/tradablePairs.11142220.d.ts +2 -0
  25. package/dist/esm/constants/tradablePairs.11142220.js +7388 -0
  26. package/dist/esm/constants/tradablePairs.42220.js +1 -1
  27. package/dist/esm/constants/tradablePairs.44787.js +1 -1
  28. package/dist/esm/constants/tradablePairs.js +2 -0
  29. package/dist/esm/enums/chainId.d.ts +1 -0
  30. package/dist/esm/enums/chainId.js +1 -0
  31. package/dist/esm/mento.d.ts +20 -0
  32. package/dist/esm/mento.js +46 -2
  33. package/dist/esm/types/contractAddressMap.d.ts +1 -1
  34. package/dist/esm/utils.d.ts +15 -6
  35. package/dist/esm/utils.js +29 -20
  36. package/package.json +12 -8
package/README.md CHANGED
@@ -28,39 +28,34 @@ yarn cacheTradablePairs
28
28
 
29
29
  ## Token Graph Visualization
30
30
 
31
- Current token connectivity on Celo Mainnet (last updated: 2025-06-19):
31
+ Current token connectivity on Celo Mainnet (last updated: 2025-09-19):
32
32
 
33
33
  ```mermaid
34
34
  graph TD
35
35
  USDT["USD₮"]
36
36
  USDC --- cUSD
37
- USDT --- cUSD
38
- CELO --- cEUR
39
- CELO --- cREAL
40
- USDC --- cREAL
41
- USDC --- cEUR
42
37
  axlUSDC --- cUSD
38
+ USDT --- cUSD
39
+ cAUD --- cUSD
40
+ cCAD --- cUSD
43
41
  CELO --- cUSD
44
- PUSO --- cUSD
45
- cJPY --- cUSD
46
- cCOP --- cUSD
47
42
  cGBP --- cUSD
48
43
  cUSD --- cZAR
49
- cCAD --- cUSD
50
- cAUD --- cUSD
51
44
  cCHF --- cUSD
52
- axlUSDC --- cEUR
53
- axlUSDC --- cREAL
45
+ PUSO --- cUSD
46
+ cJPY --- cUSD
47
+ cCOP --- cUSD
48
+ cREAL --- cUSD
54
49
  axlEUROC --- cEUR
55
- cKES --- cUSD
50
+ cEUR --- cUSD
56
51
  cGHS --- cUSD
57
52
  cNGN --- cUSD
58
- CELO --- eXOF
59
- axlEUROC --- eXOF
53
+ cKES --- cUSD
54
+ cUSD --- eXOF
60
55
 
61
56
  ```
62
57
 
63
- **Network Stats:** 20 tokens, 24 direct trading pairs
58
+ **Network Stats:** 20 tokens, 19 direct trading pairs
64
59
 
65
60
  > 💡 This graph shows direct trading pairs only. The SDK automatically finds optimal routes including multi-hop paths.
66
61
  >
@@ -4,51 +4,67 @@ exports.getAddress = exports.addresses = void 0;
4
4
  const enums_1 = require("./../enums");
5
5
  exports.addresses = {
6
6
  [enums_1.ChainId.CELO]: {
7
- GovernanceFactory: '0xee6CE2dbe788dFC38b8F583Da86cB9caf2C8cF5A',
7
+ // Oracles & Breakers
8
+ BreakerBox: '0x303ED1df62Fa067659B586EbEe8De0EcE824Ab39',
9
+ MedianDeltaBreaker: '0x49349F92D2B17d491e42C8fdB02D19f072F9B5D9',
10
+ SortedOracles: '0xefB84935239dAcdecF7c5bA76d8dE40b077B7b33',
11
+ ValueDeltaBreaker: '0x4DBC33B3abA78475A5AA4BC7A5B11445d387BF68',
12
+ // DEX
13
+ BiPoolManager: '0x22d9db95E6Ae61c104A7B6F6C78D7993B94ec901',
14
+ Broker: '0x777A8255cA72412f0d706dc03C9D1987306B4CaD',
15
+ ConstantProductPricingModule: '0x0c07126d0CB30E66eF7553Cc7C37143B4f06DddB',
16
+ ConstantSumPricingModule: '0xDebED1F6f6ce9F6e73AA25F95acBFFE2397550Fb',
17
+ MentoRouter: '0xbe729350f8cdfc19db6866e8579841188ee57f67',
18
+ Reserve: '0x9380fA34Fd9e4Fd14c06305fd7B6199089eD4eb9',
19
+ // Governance
8
20
  Airgrab: '0x7D8E73deafDBAfc98fDBe7974168cFA6d8B9AE0C',
9
21
  Emission: '0x5C789592E2611df1873b46D394c69f75faB99778',
22
+ Locking: '0x001Bb66636dCd149A1A2bA8C50E408BdDd80279C',
10
23
  MentoGovernor: '0x47036d78bB3169b4F5560dD77BF93f4412A59852',
11
24
  MentoToken: '0x7FF62f59e3e89EA34163EA1458EEBCc81177Cfb6',
12
25
  TimelockController: '0x890DB8A597940165901372Dd7DB61C9f246e2147',
13
- Locking: '0x001Bb66636dCd149A1A2bA8C50E408BdDd80279C',
14
- MentoRouter: '0xbe729350f8cdfc19db6866e8579841188ee57f67',
15
- Broker: '0x777A8255cA72412f0d706dc03C9D1987306B4CaD',
16
- BiPoolManager: '0x22d9db95E6Ae61c104A7B6F6C78D7993B94ec901',
17
- BreakerBox: '0x303ED1df62Fa067659B586EbEe8De0EcE824Ab39',
18
- Reserve: '0x9380fA34Fd9e4Fd14c06305fd7B6199089eD4eb9',
19
- ConstantSumPricingModule: '0xDebED1F6f6ce9F6e73AA25F95acBFFE2397550Fb',
20
- ConstantProductPricingModule: '0x0c07126d0CB30E66eF7553Cc7C37143B4f06DddB',
21
- MedianDeltaBreaker: '0x49349F92D2B17d491e42C8fdB02D19f072F9B5D9',
22
- ValueDeltaBreaker: '0x4DBC33B3abA78475A5AA4BC7A5B11445d387BF68',
23
- StableToken: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
24
- StableTokenEUR: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
25
- StableTokenBRL: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
26
- StableTokenXOF: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
27
- SortedOracles: '0xefB84935239dAcdecF7c5bA76d8dE40b077B7b33',
28
26
  },
29
27
  [enums_1.ChainId.ALFAJORES]: {
30
- GovernanceFactory: '0x96Fe03DBFEc1EB419885a01d2335bE7c1a45e33b',
28
+ // Oracles & Breakers
29
+ BreakerBox: '0xC76BDf0AFb654888728003683cf748A8B1b4f5fD',
30
+ MedianDeltaBreaker: '0x6B0a2076713fDAef4F9301fe8404a228e3682DE4',
31
+ SortedOracles: '0xFdd8bD58115FfBf04e47411c1d228eCC45E93075',
32
+ ValueDeltaBreaker: '0xfa6fFf746a5E74055e432f3bba26138956AEfbFe',
33
+ // DEX
34
+ BiPoolManager: '0x9B64E8EaBD1a035b148cE970d3319c5C3Ad53EC3',
35
+ Broker: '0xD3Dff18E465bCa6241A244144765b4421Ac14D09',
36
+ ConstantProductPricingModule: '0x99EDce8143FF8AeFA1fBB6C2103B349Add2B9519',
37
+ ConstantSumPricingModule: '0x474DBf1eDF845410bdaC6aeE97C3CC403651ba2E',
38
+ MentoRouter: '0xe6101a457a69b53e298e35a7f6e3dcb0390df02a',
39
+ Reserve: '0xa7ed835288Aa4524bB6C73DD23c0bF4315D9Fe3e',
40
+ // Governance
31
41
  Airgrab: '0x8dC9282F0a74A2a36F41440e009AA0EADFe490c5',
32
42
  Emission: '0xe62cc88ca2A5E7Dd3Fe5ce8511C874e610Ddb0b6',
43
+ Locking: '0x537CaE97C588C6DA64A385817F3D3563DDCf0591',
33
44
  MentoGovernor: '0x558e92236f85Bb4e8A63ec0D5Bf9d34087Eab744',
34
45
  MentoToken: '0x3eDd2f7c90e2E931c817a44302Af7112E84be6Cc',
35
46
  TimelockController: '0xa0Ad8DD40104556122c21dF50eD14bb1B53A3338',
36
- Locking: '0x537CaE97C588C6DA64A385817F3D3563DDCf0591',
37
- MentoRouter: '0xe6101a457a69b53e298e35a7f6e3dcb0390df02a',
38
- Broker: '0xD3Dff18E465bCa6241A244144765b4421Ac14D09',
39
- BiPoolManager: '0x9B64E8EaBD1a035b148cE970d3319c5C3Ad53EC3',
40
- BreakerBox: '0xC76BDf0AFb654888728003683cf748A8B1b4f5fD',
41
- Reserve: '0xa7ed835288Aa4524bB6C73DD23c0bF4315D9Fe3e',
42
- ConstantSumPricingModule: '0x474DBf1eDF845410bdaC6aeE97C3CC403651ba2E',
43
- ConstantProductPricingModule: '0x99EDce8143FF8AeFA1fBB6C2103B349Add2B9519',
44
- MedianDeltaBreaker: '0x6B0a2076713fDAef4F9301fe8404a228e3682DE4',
45
- ValueDeltaBreaker: '0xfa6fFf746a5E74055e432f3bba26138956AEfbFe',
46
- StableToken: '0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1',
47
- StableTokenEUR: '0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F',
48
- StableTokenBRL: '0xE4D517785D091D3c54818832dB6094bcc2744545',
49
- StableTokenXOF: '0xB0FA15e002516d0301884059c0aaC0F0C72b019D',
50
- SortedOracles: '0xFdd8bD58115FfBf04e47411c1d228eCC45E93075',
51
47
  },
48
+ [enums_1.ChainId.CELO_SEPOLIA]: {
49
+ // Oracles & Breakers
50
+ BreakerBox: '0x578bD46003B9D3fd4c3C3f47c98B329562a6a1dE',
51
+ MedianDeltaBreaker: '0xd29B4e743F7B84D63fBF9149B6D983DF2eF5C952',
52
+ SortedOracles: '0xfaa7Ca2B056E60F6733aE75AA0709140a6eAfD20',
53
+ ValueDeltaBreaker: '0x03CDf2966185Eb0b980f2481Ad386B8aFdAB4534',
54
+ // DEX
55
+ BiPoolManager: '0xeCB3C656C131fCd9bB8D1d80898716bD684feb78',
56
+ Broker: '0xB9Ae2065142EB79b6c5EB1E8778F883fad6B07Ba',
57
+ ConstantProductPricingModule: '0x2584a5835e3aE7E901e6462E1de06920c2C68028',
58
+ ConstantSumPricingModule: '0x3b199d9EbEbe509bb711BfFb455c2d79102A9602',
59
+ MentoRouter: '0x8e4Fb12D86D5DF911086a9153e79CA27e0c96156',
60
+ Reserve: '0x2bC2D48735842924C508468C5A02580aD4F6d99A',
61
+ // Governance
62
+ Emission: '0x3C1BEA0F35b5dcAc1065CA9b3b6877657dEa4A69',
63
+ Locking: '0xB72320fC501cb30E55bAF0DA48c20b11fAc9f79D',
64
+ MentoGovernor: '0x23173Ac37b8E4e5a60d787aC543B3F51e8f398b4',
65
+ MentoToken: '0x07867fd40EB56b4380bE39c88D0a7EA59Aa99A20',
66
+ TimelockController: '0x74c44Be99937815173A3C56274331e0A05611e0D',
67
+ }
52
68
  };
53
69
  function getAddress(identifier, chainId) {
54
70
  const addressesForChain = exports.addresses[chainId];
@@ -0,0 +1,5 @@
1
+ /**
2
+ * List of supported currencies for rate feed generation and validation
3
+ */
4
+ export declare const CURRENCIES: readonly ["AUD", "USD", "PHP", "ZAR", "CAD", "EUR", "BRL", "XOF", "COP", "GHS", "CHF", "NGN", "JPY", "GBP", "KES", "CELO", "ETH", "EURC", "EUROC", "USDC", "USDT"];
5
+ export type Currency = typeof CURRENCIES[number];
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CURRENCIES = void 0;
4
+ /**
5
+ * List of supported currencies for rate feed generation and validation
6
+ */
7
+ exports.CURRENCIES = [
8
+ "AUD",
9
+ "USD",
10
+ "PHP",
11
+ "ZAR",
12
+ "CAD",
13
+ "EUR",
14
+ "BRL",
15
+ "XOF",
16
+ "COP",
17
+ "GHS",
18
+ "CHF",
19
+ "NGN",
20
+ "JPY",
21
+ "GBP",
22
+ "KES",
23
+ "CELO",
24
+ "ETH",
25
+ "EURC",
26
+ "EUROC",
27
+ "USDC",
28
+ "USDT"
29
+ ];
@@ -1,2 +1,3 @@
1
1
  export * from './addresses';
2
+ export * from './currencies';
2
3
  export * from './tradablePairs';
@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./addresses"), exports);
18
+ __exportStar(require("./currencies"), exports);
18
19
  __exportStar(require("./tradablePairs"), exports);
@@ -0,0 +1,2 @@
1
+ import { TradablePairWithSpread } from './tradablePairs';
2
+ export declare const tradablePairs11142220: TradablePairWithSpread[];