@mento-protocol/mento-sdk 1.10.2 → 1.11.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 (34) hide show
  1. package/README.md +16 -18
  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 +2880 -1896
  10. package/dist/cjs/constants/tradablePairs.44787.js +1 -1
  11. package/dist/cjs/enums/chainId.d.ts +3 -1
  12. package/dist/cjs/enums/chainId.js +2 -0
  13. package/dist/cjs/mento.d.ts +4 -0
  14. package/dist/cjs/mento.js +15 -1
  15. package/dist/cjs/types/contractAddressMap.d.ts +1 -1
  16. package/dist/cjs/utils.d.ts +1 -6
  17. package/dist/cjs/utils.js +5 -22
  18. package/dist/esm/constants/addresses.js +48 -32
  19. package/dist/esm/constants/currencies.d.ts +5 -0
  20. package/dist/esm/constants/currencies.js +26 -0
  21. package/dist/esm/constants/index.d.ts +1 -0
  22. package/dist/esm/constants/index.js +1 -0
  23. package/dist/esm/constants/tradablePairs.11142220.d.ts +2 -0
  24. package/dist/esm/constants/tradablePairs.11142220.js +7388 -0
  25. package/dist/esm/constants/tradablePairs.42220.js +2880 -1896
  26. package/dist/esm/constants/tradablePairs.44787.js +1 -1
  27. package/dist/esm/enums/chainId.d.ts +3 -1
  28. package/dist/esm/enums/chainId.js +2 -0
  29. package/dist/esm/mento.d.ts +4 -0
  30. package/dist/esm/mento.js +16 -2
  31. package/dist/esm/types/contractAddressMap.d.ts +1 -1
  32. package/dist/esm/utils.d.ts +1 -6
  33. package/dist/esm/utils.js +4 -21
  34. package/package.json +10 -7
package/README.md CHANGED
@@ -26,42 +26,40 @@ The `yarn cacheTradablePairs` script generates a TypeScript file containing a li
26
26
  yarn cacheTradablePairs
27
27
  ```
28
28
 
29
+
29
30
  ## Token Graph Visualization
30
31
 
31
- Current token connectivity on Celo Mainnet (last updated: 2025-06-19):
32
+ Current token connectivity on Celo Mainnet (last updated: 2025-09-19):
32
33
 
33
34
  ```mermaid
34
35
  graph TD
35
36
  USDT["USD₮"]
36
37
  USDC --- cUSD
37
- USDT --- cUSD
38
- CELO --- cEUR
39
- CELO --- cREAL
40
- USDC --- cREAL
41
- USDC --- cEUR
42
38
  axlUSDC --- cUSD
39
+ USDT --- cUSD
40
+ cAUD --- cUSD
41
+ cCAD --- cUSD
43
42
  CELO --- cUSD
44
- PUSO --- cUSD
45
- cJPY --- cUSD
46
- cCOP --- cUSD
47
43
  cGBP --- cUSD
48
44
  cUSD --- cZAR
49
- cCAD --- cUSD
50
- cAUD --- cUSD
51
45
  cCHF --- cUSD
52
- axlUSDC --- cEUR
53
- axlUSDC --- cREAL
46
+ PUSO --- cUSD
47
+ cJPY --- cUSD
48
+ cCOP --- cUSD
49
+ cREAL --- cUSD
54
50
  axlEUROC --- cEUR
55
- cKES --- cUSD
51
+ cEUR --- cUSD
56
52
  cGHS --- cUSD
57
53
  cNGN --- cUSD
58
- CELO --- eXOF
59
- axlEUROC --- eXOF
54
+ cKES --- cUSD
55
+ cUSD --- eXOF
60
56
 
61
57
  ```
62
58
 
63
- **Network Stats:** 20 tokens, 24 direct trading pairs
59
+ **Network Stats:** 20 tokens, 19 direct trading pairs
64
60
 
65
61
  > 💡 This graph shows direct trading pairs only. The SDK automatically finds optimal routes including multi-hop paths.
66
- >
62
+ >
67
63
  > To regenerate: `yarn getTokenGraph`
64
+
65
+
@@ -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[];