@mento-protocol/mento-sdk 1.14.0 → 1.15.1

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 (15) hide show
  1. package/dist/cjs/constants/tokens.11142220.js +1 -1
  2. package/dist/cjs/constants/tokens.42220.js +1 -1
  3. package/dist/cjs/constants/tokens.44787.js +1 -1
  4. package/dist/cjs/constants/tokens.d.ts +30 -25
  5. package/dist/cjs/constants/tokens.js +88 -89
  6. package/dist/cjs/mento.d.ts +2 -1
  7. package/dist/cjs/utils.d.ts +2 -1
  8. package/dist/esm/constants/tokens.11142220.js +1 -1
  9. package/dist/esm/constants/tokens.42220.js +1 -1
  10. package/dist/esm/constants/tokens.44787.js +1 -1
  11. package/dist/esm/constants/tokens.d.ts +30 -25
  12. package/dist/esm/constants/tokens.js +88 -89
  13. package/dist/esm/mento.d.ts +2 -1
  14. package/dist/esm/utils.d.ts +2 -1
  15. package/package.json +1 -1
package/dist/cjs/constants/tokens.11142220.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  // This file is auto-generated. Do not edit manually.
3
- // Generated on 2025-10-02T13:54:45.876Z
3
+ // Generated on 2025-10-06T11:40:10.815Z
4
4
  Object.defineProperty(exports, "__esModule", { value: true });
5
5
  exports.tokens11142220 = void 0;
6
6
  exports.tokens11142220 = [
package/dist/cjs/constants/tokens.42220.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  // This file is auto-generated. Do not edit manually.
3
- // Generated on 2025-10-02T13:54:27.948Z
3
+ // Generated on 2025-10-06T11:39:47.674Z
4
4
  Object.defineProperty(exports, "__esModule", { value: true });
5
5
  exports.tokens42220 = void 0;
6
6
  exports.tokens42220 = [
package/dist/cjs/constants/tokens.44787.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  // This file is auto-generated. Do not edit manually.
3
- // Generated on 2025-10-02T13:54:36.998Z
3
+ // Generated on 2025-10-06T11:40:01.073Z
4
4
  Object.defineProperty(exports, "__esModule", { value: true });
5
5
  exports.tokens44787 = void 0;
6
6
  exports.tokens44787 = [
package/dist/cjs/constants/tokens.d.ts CHANGED
@@ -19,31 +19,36 @@ export declare function getCachedTokensSync(chainId: number): readonly Token[];
19
19
  * Type-safe token symbols available across all chains
20
20
  * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
21
21
  */
22
- export declare enum TokenSymbol {
23
- BridgedEUROC = "BridgedEUROC",
24
- BridgedUSDC = "BridgedUSDC",
25
- CELO = "CELO",
26
- PUSO = "PUSO",
27
- USDC = "USDC",
28
- USDT = "USDT",
29
- USD_ = "USD\u20AE",
30
- axlEUROC = "axlEUROC",
31
- axlUSDC = "axlUSDC",
32
- cAUD = "cAUD",
33
- cCAD = "cCAD",
34
- cCHF = "cCHF",
35
- cCOP = "cCOP",
36
- cEUR = "cEUR",
37
- cGBP = "cGBP",
38
- cGHS = "cGHS",
39
- cJPY = "cJPY",
40
- cKES = "cKES",
41
- cNGN = "cNGN",
42
- cREAL = "cREAL",
43
- cUSD = "cUSD",
44
- cZAR = "cZAR",
45
- eXOF = "eXOF"
46
- }
22
+ export type TokenSymbol = 'BridgedEUROC' | 'BridgedUSDC' | 'CELO' | 'PUSO' | 'USDC' | 'USDT' | 'USD₮' | 'axlEUROC' | 'axlUSDC' | 'cAUD' | 'cCAD' | 'cCHF' | 'cCOP' | 'cEUR' | 'cGBP' | 'cGHS' | 'cJPY' | 'cKES' | 'cNGN' | 'cREAL' | 'cUSD' | 'cZAR' | 'eXOF';
23
+ /**
24
+ * Enum-like object for accessing token symbols
25
+ * Use this in consuming packages: TokenSymbol.CELO, TokenSymbol.cUSD, etc.
26
+ */
27
+ export declare const TokenSymbol: {
28
+ readonly BridgedEUROC: "BridgedEUROC";
29
+ readonly BridgedUSDC: "BridgedUSDC";
30
+ readonly CELO: "CELO";
31
+ readonly PUSO: "PUSO";
32
+ readonly USDC: "USDC";
33
+ readonly USDT: "USDT";
34
+ readonly USD_: "USD₮";
35
+ readonly axlEUROC: "axlEUROC";
36
+ readonly axlUSDC: "axlUSDC";
37
+ readonly cAUD: "cAUD";
38
+ readonly cCAD: "cCAD";
39
+ readonly cCHF: "cCHF";
40
+ readonly cCOP: "cCOP";
41
+ readonly cEUR: "cEUR";
42
+ readonly cGBP: "cGBP";
43
+ readonly cGHS: "cGHS";
44
+ readonly cJPY: "cJPY";
45
+ readonly cKES: "cKES";
46
+ readonly cNGN: "cNGN";
47
+ readonly cREAL: "cREAL";
48
+ readonly cUSD: "cUSD";
49
+ readonly cZAR: "cZAR";
50
+ readonly eXOF: "eXOF";
51
+ };
47
52
  /**
48
53
  * Token addresses mapped by chain ID and symbol
49
54
  * Use this for type-safe token address lookups
package/dist/cjs/constants/tokens.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  // This file is auto-generated. Do not edit manually.
3
- // Generated on 2025-10-02T13:54:45.878Z
3
+ // Generated on 2025-10-06T11:40:10.818Z
4
4
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
5
5
  if (k2 === undefined) k2 = k;
6
6
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -82,105 +82,104 @@ function getCachedTokensSync(chainId) {
82
82
  }
83
83
  exports.getCachedTokensSync = getCachedTokensSync;
84
84
  /**
85
- * Type-safe token symbols available across all chains
86
- * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
85
+ * Enum-like object for accessing token symbols
86
+ * Use this in consuming packages: TokenSymbol.CELO, TokenSymbol.cUSD, etc.
87
87
  */
88
- var TokenSymbol;
89
- (function (TokenSymbol) {
90
- TokenSymbol["BridgedEUROC"] = "BridgedEUROC";
91
- TokenSymbol["BridgedUSDC"] = "BridgedUSDC";
92
- TokenSymbol["CELO"] = "CELO";
93
- TokenSymbol["PUSO"] = "PUSO";
94
- TokenSymbol["USDC"] = "USDC";
95
- TokenSymbol["USDT"] = "USDT";
96
- TokenSymbol["USD_"] = "USD\u20AE";
97
- TokenSymbol["axlEUROC"] = "axlEUROC";
98
- TokenSymbol["axlUSDC"] = "axlUSDC";
99
- TokenSymbol["cAUD"] = "cAUD";
100
- TokenSymbol["cCAD"] = "cCAD";
101
- TokenSymbol["cCHF"] = "cCHF";
102
- TokenSymbol["cCOP"] = "cCOP";
103
- TokenSymbol["cEUR"] = "cEUR";
104
- TokenSymbol["cGBP"] = "cGBP";
105
- TokenSymbol["cGHS"] = "cGHS";
106
- TokenSymbol["cJPY"] = "cJPY";
107
- TokenSymbol["cKES"] = "cKES";
108
- TokenSymbol["cNGN"] = "cNGN";
109
- TokenSymbol["cREAL"] = "cREAL";
110
- TokenSymbol["cUSD"] = "cUSD";
111
- TokenSymbol["cZAR"] = "cZAR";
112
- TokenSymbol["eXOF"] = "eXOF";
113
- })(TokenSymbol = exports.TokenSymbol || (exports.TokenSymbol = {}));
88
+ exports.TokenSymbol = {
89
+ BridgedEUROC: 'BridgedEUROC',
90
+ BridgedUSDC: 'BridgedUSDC',
91
+ CELO: 'CELO',
92
+ PUSO: 'PUSO',
93
+ USDC: 'USDC',
94
+ USDT: 'USDT',
95
+ USD_: 'USD₮',
96
+ axlEUROC: 'axlEUROC',
97
+ axlUSDC: 'axlUSDC',
98
+ cAUD: 'cAUD',
99
+ cCAD: 'cCAD',
100
+ cCHF: 'cCHF',
101
+ cCOP: 'cCOP',
102
+ cEUR: 'cEUR',
103
+ cGBP: 'cGBP',
104
+ cGHS: 'cGHS',
105
+ cJPY: 'cJPY',
106
+ cKES: 'cKES',
107
+ cNGN: 'cNGN',
108
+ cREAL: 'cREAL',
109
+ cUSD: 'cUSD',
110
+ cZAR: 'cZAR',
111
+ eXOF: 'eXOF',
112
+ };
114
113
  /**
115
114
  * Token addresses mapped by chain ID and symbol
116
115
  * Use this for type-safe token address lookups
117
116
  */
118
117
  exports.TOKEN_ADDRESSES_BY_CHAIN = {
119
118
  42220: {
120
- [TokenSymbol.axlEUROC]: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
121
- [TokenSymbol.axlUSDC]: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
122
- [TokenSymbol.cAUD]: '0x7175504C455076F15c04A2F90a8e352281F492F9',
123
- [TokenSymbol.cCAD]: '0xff4Ab19391af240c311c54200a492233052B6325',
124
- [TokenSymbol.cCHF]: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
125
- [TokenSymbol.cCOP]: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
126
- [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
127
- [TokenSymbol.cEUR]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
128
- [TokenSymbol.cGBP]: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
129
- [TokenSymbol.cGHS]: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
130
- [TokenSymbol.cJPY]: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
131
- [TokenSymbol.cKES]: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
132
- [TokenSymbol.cNGN]: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
133
- [TokenSymbol.cREAL]: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
134
- [TokenSymbol.cUSD]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
135
- [TokenSymbol.cZAR]: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
136
- [TokenSymbol.eXOF]: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
137
- [TokenSymbol.PUSO]: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
138
- [TokenSymbol.USD_]: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
139
- [TokenSymbol.USDC]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
119
+ axlEUROC: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
120
+ axlUSDC: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
121
+ cAUD: '0x7175504C455076F15c04A2F90a8e352281F492F9',
122
+ cCAD: '0xff4Ab19391af240c311c54200a492233052B6325',
123
+ cCHF: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
124
+ cCOP: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
125
+ CELO: '0x471EcE3750Da237f93B8E339c536989b8978a438',
126
+ cEUR: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
127
+ cGBP: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
128
+ cGHS: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
129
+ cJPY: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
130
+ cKES: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
131
+ cNGN: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
132
+ cREAL: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
133
+ cUSD: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
134
+ cZAR: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
135
+ eXOF: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
136
+ PUSO: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
137
+ 'USD₮': '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
138
+ USDC: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
140
139
  },
141
140
  44787: {
142
- [TokenSymbol.BridgedEUROC]: '0x6e673502c5b55F3169657C004e5797fFE5be6653',
143
- [TokenSymbol.BridgedUSDC]: '0x87D61dA3d668797786D73BC674F053f87111570d',
144
- [TokenSymbol.cAUD]: '0x84CBD49F5aE07632B6B88094E81Cce8236125Fe0',
145
- [TokenSymbol.cCAD]: '0x02EC9E0D2Fd73e89168C1709e542a48f58d7B133',
146
- [TokenSymbol.cCHF]: '0xADC57C2C34aD021Df4421230a6532F4e2E1dCE4F',
147
- [TokenSymbol.cCOP]: '0xe6A57340f0df6E020c1c0a80bC6E13048601f0d4',
148
- [TokenSymbol.CELO]: '0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9',
149
- [TokenSymbol.cEUR]: '0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F',
150
- [TokenSymbol.cGBP]: '0x47f2Fb88105155a18c390641C8a73f1402B2BB12',
151
- [TokenSymbol.cGHS]: '0x295B66bE7714458Af45E6A6Ea142A5358A6cA375',
152
- [TokenSymbol.cJPY]: '0x2E51F41238cA36a421C9B8b3e189e8Cc7653FE67',
153
- [TokenSymbol.cKES]: '0x1E0433C1769271ECcF4CFF9FDdD515eefE6CdF92',
154
- [TokenSymbol.cNGN]: '0x4a5b03B8b16122D330306c65e4CA4BC5Dd6511d0',
155
- [TokenSymbol.cREAL]: '0xE4D517785D091D3c54818832dB6094bcc2744545',
156
- [TokenSymbol.cUSD]: '0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1',
157
- [TokenSymbol.cZAR]: '0x1e5b44015Ff90610b54000DAad31C89b3284df4d',
158
- [TokenSymbol.eXOF]: '0xB0FA15e002516d0301884059c0aaC0F0C72b019D',
159
- [TokenSymbol.PUSO]: '0x5E0E3c9419C42a1B04e2525991FB1A2C467AB8bF',
160
- [TokenSymbol.USDC]: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
161
- [TokenSymbol.USDT]: '0xBba91F588d031469ABCCA566FE80fB1Ad8Ee3287',
141
+ BridgedEUROC: '0x6e673502c5b55F3169657C004e5797fFE5be6653',
142
+ BridgedUSDC: '0x87D61dA3d668797786D73BC674F053f87111570d',
143
+ cAUD: '0x84CBD49F5aE07632B6B88094E81Cce8236125Fe0',
144
+ cCAD: '0x02EC9E0D2Fd73e89168C1709e542a48f58d7B133',
145
+ cCHF: '0xADC57C2C34aD021Df4421230a6532F4e2E1dCE4F',
146
+ cCOP: '0xe6A57340f0df6E020c1c0a80bC6E13048601f0d4',
147
+ CELO: '0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9',
148
+ cEUR: '0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F',
149
+ cGBP: '0x47f2Fb88105155a18c390641C8a73f1402B2BB12',
150
+ cGHS: '0x295B66bE7714458Af45E6A6Ea142A5358A6cA375',
151
+ cJPY: '0x2E51F41238cA36a421C9B8b3e189e8Cc7653FE67',
152
+ cKES: '0x1E0433C1769271ECcF4CFF9FDdD515eefE6CdF92',
153
+ cNGN: '0x4a5b03B8b16122D330306c65e4CA4BC5Dd6511d0',
154
+ cREAL: '0xE4D517785D091D3c54818832dB6094bcc2744545',
155
+ cUSD: '0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1',
156
+ cZAR: '0x1e5b44015Ff90610b54000DAad31C89b3284df4d',
157
+ eXOF: '0xB0FA15e002516d0301884059c0aaC0F0C72b019D',
158
+ PUSO: '0x5E0E3c9419C42a1B04e2525991FB1A2C467AB8bF',
159
+ USDC: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
160
+ USDT: '0xBba91F588d031469ABCCA566FE80fB1Ad8Ee3287',
162
161
  },
163
162
  11142220: {
164
- [TokenSymbol.axlEUROC]: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
165
- [TokenSymbol.axlUSDC]: '0x6285De9DA7C1d329C0451628638908915002d9d1',
166
- [TokenSymbol.cAUD]: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
167
- [TokenSymbol.cCAD]: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
168
- [TokenSymbol.cCHF]: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
169
- [TokenSymbol.cCOP]: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
170
- [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
171
- [TokenSymbol.cEUR]: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
172
- [TokenSymbol.cGBP]: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
173
- [TokenSymbol.cGHS]: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
174
- [TokenSymbol.cJPY]: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
175
- [TokenSymbol.cKES]: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
176
- [TokenSymbol.cNGN]: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
177
- [TokenSymbol.cREAL]: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
178
- [TokenSymbol.cUSD]: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
179
- [TokenSymbol.cZAR]: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
180
- [TokenSymbol.eXOF]: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
181
- [TokenSymbol.PUSO]: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
182
- [TokenSymbol.USDC]: '0xBD63e46Be8eF8D89dFde3054E7b9ECAEb8Ad83e9',
183
- [TokenSymbol.USDT]: '0xCA53d9b72646B254d29EBeEb4c5cde7BB4bb59e0',
163
+ axlEUROC: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
164
+ axlUSDC: '0x6285De9DA7C1d329C0451628638908915002d9d1',
165
+ cAUD: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
166
+ cCAD: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
167
+ cCHF: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
168
+ cCOP: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
169
+ CELO: '0x471EcE3750Da237f93B8E339c536989b8978a438',
170
+ cEUR: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
171
+ cGBP: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
172
+ cGHS: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
173
+ cJPY: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
174
+ cKES: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
175
+ cNGN: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
176
+ cREAL: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
177
+ cUSD: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
178
+ cZAR: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
179
+ eXOF: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
180
+ PUSO: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
181
+ USDC: '0xBD63e46Be8eF8D89dFde3054E7b9ECAEb8Ad83e9',
182
+ USDT: '0xCA53d9b72646B254d29EBeEb4c5cde7BB4bb59e0',
184
183
  },
185
184
  };
186
185
  /**
package/dist/cjs/mento.d.ts CHANGED
@@ -2,6 +2,7 @@ import { IBroker } from '@mento-protocol/mento-core-ts';
2
2
  import { BigNumber, BigNumberish, providers, Signer } from 'ethers';
3
3
  import { Address, TradingLimit, TradingLimitsConfig, TradingLimitsState } from './interfaces';
4
4
  import { Identifier } from './constants/addresses';
5
+ import { TokenSymbol } from './constants/tokens';
5
6
  import { TradablePairWithSpread } from './constants/tradablePairs';
6
7
  export interface Exchange {
7
8
  providerAddr: Address;
@@ -14,7 +15,7 @@ export interface Asset {
14
15
  }
15
16
  export interface Token {
16
17
  address: Address;
17
- symbol: string;
18
+ symbol: TokenSymbol;
18
19
  name: string;
19
20
  decimals: number;
20
21
  }
package/dist/cjs/utils.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { BigNumberish, providers, Signer } from 'ethers';
2
+ import { TokenSymbol } from './constants';
2
3
  import { Address } from './interfaces';
3
4
  import { TradablePair } from './mento';
4
5
  /**
@@ -25,7 +26,7 @@ export declare function validateSignerOrProvider(signerOrProvider: Signer | prov
25
26
  * @param signerOrProvider an ethers provider or signer
26
27
  * @returns the symbol of the erc20 token
27
28
  */
28
- export declare function getSymbolFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<string>;
29
+ export declare function getSymbolFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<TokenSymbol>;
29
30
  /**
30
31
  * Returns the name of an erc20 token
31
32
  * @param tokenAddr the address of the erc20 token
package/dist/esm/constants/tokens.11142220.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // This file is auto-generated. Do not edit manually.
2
- // Generated on 2025-10-02T13:54:45.876Z
2
+ // Generated on 2025-10-06T11:40:10.815Z
3
3
  export const tokens11142220 = [
4
4
  {
5
5
  "address": "0x9883d788d40F1C7595a780ed881Ea833C7743B4B",
package/dist/esm/constants/tokens.42220.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // This file is auto-generated. Do not edit manually.
2
- // Generated on 2025-10-02T13:54:27.948Z
2
+ // Generated on 2025-10-06T11:39:47.674Z
3
3
  export const tokens42220 = [
4
4
  {
5
5
  "address": "0x061cc5a2C863E0C1Cb404006D559dB18A34C762d",
package/dist/esm/constants/tokens.44787.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // This file is auto-generated. Do not edit manually.
2
- // Generated on 2025-10-02T13:54:36.998Z
2
+ // Generated on 2025-10-06T11:40:01.073Z
3
3
  export const tokens44787 = [
4
4
  {
5
5
  "address": "0x6e673502c5b55F3169657C004e5797fFE5be6653",
package/dist/esm/constants/tokens.d.ts CHANGED
@@ -19,31 +19,36 @@ export declare function getCachedTokensSync(chainId: number): readonly Token[];
19
19
  * Type-safe token symbols available across all chains
20
20
  * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
21
21
  */
22
- export declare enum TokenSymbol {
23
- BridgedEUROC = "BridgedEUROC",
24
- BridgedUSDC = "BridgedUSDC",
25
- CELO = "CELO",
26
- PUSO = "PUSO",
27
- USDC = "USDC",
28
- USDT = "USDT",
29
- USD_ = "USD\u20AE",
30
- axlEUROC = "axlEUROC",
31
- axlUSDC = "axlUSDC",
32
- cAUD = "cAUD",
33
- cCAD = "cCAD",
34
- cCHF = "cCHF",
35
- cCOP = "cCOP",
36
- cEUR = "cEUR",
37
- cGBP = "cGBP",
38
- cGHS = "cGHS",
39
- cJPY = "cJPY",
40
- cKES = "cKES",
41
- cNGN = "cNGN",
42
- cREAL = "cREAL",
43
- cUSD = "cUSD",
44
- cZAR = "cZAR",
45
- eXOF = "eXOF"
46
- }
22
+ export type TokenSymbol = 'BridgedEUROC' | 'BridgedUSDC' | 'CELO' | 'PUSO' | 'USDC' | 'USDT' | 'USD₮' | 'axlEUROC' | 'axlUSDC' | 'cAUD' | 'cCAD' | 'cCHF' | 'cCOP' | 'cEUR' | 'cGBP' | 'cGHS' | 'cJPY' | 'cKES' | 'cNGN' | 'cREAL' | 'cUSD' | 'cZAR' | 'eXOF';
23
+ /**
24
+ * Enum-like object for accessing token symbols
25
+ * Use this in consuming packages: TokenSymbol.CELO, TokenSymbol.cUSD, etc.
26
+ */
27
+ export declare const TokenSymbol: {
28
+ readonly BridgedEUROC: "BridgedEUROC";
29
+ readonly BridgedUSDC: "BridgedUSDC";
30
+ readonly CELO: "CELO";
31
+ readonly PUSO: "PUSO";
32
+ readonly USDC: "USDC";
33
+ readonly USDT: "USDT";
34
+ readonly USD_: "USD₮";
35
+ readonly axlEUROC: "axlEUROC";
36
+ readonly axlUSDC: "axlUSDC";
37
+ readonly cAUD: "cAUD";
38
+ readonly cCAD: "cCAD";
39
+ readonly cCHF: "cCHF";
40
+ readonly cCOP: "cCOP";
41
+ readonly cEUR: "cEUR";
42
+ readonly cGBP: "cGBP";
43
+ readonly cGHS: "cGHS";
44
+ readonly cJPY: "cJPY";
45
+ readonly cKES: "cKES";
46
+ readonly cNGN: "cNGN";
47
+ readonly cREAL: "cREAL";
48
+ readonly cUSD: "cUSD";
49
+ readonly cZAR: "cZAR";
50
+ readonly eXOF: "eXOF";
51
+ };
47
52
  /**
48
53
  * Token addresses mapped by chain ID and symbol
49
54
  * Use this for type-safe token address lookups
package/dist/esm/constants/tokens.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // This file is auto-generated. Do not edit manually.
2
- // Generated on 2025-10-02T13:54:45.878Z
2
+ // Generated on 2025-10-06T11:40:10.818Z
3
3
  var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
4
4
  function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
5
5
  return new (P || (P = Promise))(function (resolve, reject) {
@@ -54,105 +54,104 @@ export function getCachedTokensSync(chainId) {
54
54
  }
55
55
  }
56
56
  /**
57
- * Type-safe token symbols available across all chains
58
- * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
57
+ * Enum-like object for accessing token symbols
58
+ * Use this in consuming packages: TokenSymbol.CELO, TokenSymbol.cUSD, etc.
59
59
  */
60
- export var TokenSymbol;
61
- (function (TokenSymbol) {
62
- TokenSymbol["BridgedEUROC"] = "BridgedEUROC";
63
- TokenSymbol["BridgedUSDC"] = "BridgedUSDC";
64
- TokenSymbol["CELO"] = "CELO";
65
- TokenSymbol["PUSO"] = "PUSO";
66
- TokenSymbol["USDC"] = "USDC";
67
- TokenSymbol["USDT"] = "USDT";
68
- TokenSymbol["USD_"] = "USD\u20AE";
69
- TokenSymbol["axlEUROC"] = "axlEUROC";
70
- TokenSymbol["axlUSDC"] = "axlUSDC";
71
- TokenSymbol["cAUD"] = "cAUD";
72
- TokenSymbol["cCAD"] = "cCAD";
73
- TokenSymbol["cCHF"] = "cCHF";
74
- TokenSymbol["cCOP"] = "cCOP";
75
- TokenSymbol["cEUR"] = "cEUR";
76
- TokenSymbol["cGBP"] = "cGBP";
77
- TokenSymbol["cGHS"] = "cGHS";
78
- TokenSymbol["cJPY"] = "cJPY";
79
- TokenSymbol["cKES"] = "cKES";
80
- TokenSymbol["cNGN"] = "cNGN";
81
- TokenSymbol["cREAL"] = "cREAL";
82
- TokenSymbol["cUSD"] = "cUSD";
83
- TokenSymbol["cZAR"] = "cZAR";
84
- TokenSymbol["eXOF"] = "eXOF";
85
- })(TokenSymbol || (TokenSymbol = {}));
60
+ export const TokenSymbol = {
61
+ BridgedEUROC: 'BridgedEUROC',
62
+ BridgedUSDC: 'BridgedUSDC',
63
+ CELO: 'CELO',
64
+ PUSO: 'PUSO',
65
+ USDC: 'USDC',
66
+ USDT: 'USDT',
67
+ USD_: 'USD₮',
68
+ axlEUROC: 'axlEUROC',
69
+ axlUSDC: 'axlUSDC',
70
+ cAUD: 'cAUD',
71
+ cCAD: 'cCAD',
72
+ cCHF: 'cCHF',
73
+ cCOP: 'cCOP',
74
+ cEUR: 'cEUR',
75
+ cGBP: 'cGBP',
76
+ cGHS: 'cGHS',
77
+ cJPY: 'cJPY',
78
+ cKES: 'cKES',
79
+ cNGN: 'cNGN',
80
+ cREAL: 'cREAL',
81
+ cUSD: 'cUSD',
82
+ cZAR: 'cZAR',
83
+ eXOF: 'eXOF',
84
+ };
86
85
  /**
87
86
  * Token addresses mapped by chain ID and symbol
88
87
  * Use this for type-safe token address lookups
89
88
  */
90
89
  export const TOKEN_ADDRESSES_BY_CHAIN = {
91
90
  42220: {
92
- [TokenSymbol.axlEUROC]: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
93
- [TokenSymbol.axlUSDC]: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
94
- [TokenSymbol.cAUD]: '0x7175504C455076F15c04A2F90a8e352281F492F9',
95
- [TokenSymbol.cCAD]: '0xff4Ab19391af240c311c54200a492233052B6325',
96
- [TokenSymbol.cCHF]: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
97
- [TokenSymbol.cCOP]: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
98
- [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
99
- [TokenSymbol.cEUR]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
100
- [TokenSymbol.cGBP]: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
101
- [TokenSymbol.cGHS]: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
102
- [TokenSymbol.cJPY]: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
103
- [TokenSymbol.cKES]: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
104
- [TokenSymbol.cNGN]: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
105
- [TokenSymbol.cREAL]: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
106
- [TokenSymbol.cUSD]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
107
- [TokenSymbol.cZAR]: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
108
- [TokenSymbol.eXOF]: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
109
- [TokenSymbol.PUSO]: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
110
- [TokenSymbol.USD_]: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
111
- [TokenSymbol.USDC]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
91
+ axlEUROC: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
92
+ axlUSDC: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
93
+ cAUD: '0x7175504C455076F15c04A2F90a8e352281F492F9',
94
+ cCAD: '0xff4Ab19391af240c311c54200a492233052B6325',
95
+ cCHF: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
96
+ cCOP: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
97
+ CELO: '0x471EcE3750Da237f93B8E339c536989b8978a438',
98
+ cEUR: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
99
+ cGBP: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
100
+ cGHS: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
101
+ cJPY: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
102
+ cKES: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
103
+ cNGN: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
104
+ cREAL: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
105
+ cUSD: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
106
+ cZAR: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
107
+ eXOF: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
108
+ PUSO: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
109
+ 'USD₮': '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
110
+ USDC: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
112
111
  },
113
112
  44787: {
114
- [TokenSymbol.BridgedEUROC]: '0x6e673502c5b55F3169657C004e5797fFE5be6653',
115
- [TokenSymbol.BridgedUSDC]: '0x87D61dA3d668797786D73BC674F053f87111570d',
116
- [TokenSymbol.cAUD]: '0x84CBD49F5aE07632B6B88094E81Cce8236125Fe0',
117
- [TokenSymbol.cCAD]: '0x02EC9E0D2Fd73e89168C1709e542a48f58d7B133',
118
- [TokenSymbol.cCHF]: '0xADC57C2C34aD021Df4421230a6532F4e2E1dCE4F',
119
- [TokenSymbol.cCOP]: '0xe6A57340f0df6E020c1c0a80bC6E13048601f0d4',
120
- [TokenSymbol.CELO]: '0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9',
121
- [TokenSymbol.cEUR]: '0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F',
122
- [TokenSymbol.cGBP]: '0x47f2Fb88105155a18c390641C8a73f1402B2BB12',
123
- [TokenSymbol.cGHS]: '0x295B66bE7714458Af45E6A6Ea142A5358A6cA375',
124
- [TokenSymbol.cJPY]: '0x2E51F41238cA36a421C9B8b3e189e8Cc7653FE67',
125
- [TokenSymbol.cKES]: '0x1E0433C1769271ECcF4CFF9FDdD515eefE6CdF92',
126
- [TokenSymbol.cNGN]: '0x4a5b03B8b16122D330306c65e4CA4BC5Dd6511d0',
127
- [TokenSymbol.cREAL]: '0xE4D517785D091D3c54818832dB6094bcc2744545',
128
- [TokenSymbol.cUSD]: '0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1',
129
- [TokenSymbol.cZAR]: '0x1e5b44015Ff90610b54000DAad31C89b3284df4d',
130
- [TokenSymbol.eXOF]: '0xB0FA15e002516d0301884059c0aaC0F0C72b019D',
131
- [TokenSymbol.PUSO]: '0x5E0E3c9419C42a1B04e2525991FB1A2C467AB8bF',
132
- [TokenSymbol.USDC]: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
133
- [TokenSymbol.USDT]: '0xBba91F588d031469ABCCA566FE80fB1Ad8Ee3287',
113
+ BridgedEUROC: '0x6e673502c5b55F3169657C004e5797fFE5be6653',
114
+ BridgedUSDC: '0x87D61dA3d668797786D73BC674F053f87111570d',
115
+ cAUD: '0x84CBD49F5aE07632B6B88094E81Cce8236125Fe0',
116
+ cCAD: '0x02EC9E0D2Fd73e89168C1709e542a48f58d7B133',
117
+ cCHF: '0xADC57C2C34aD021Df4421230a6532F4e2E1dCE4F',
118
+ cCOP: '0xe6A57340f0df6E020c1c0a80bC6E13048601f0d4',
119
+ CELO: '0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9',
120
+ cEUR: '0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F',
121
+ cGBP: '0x47f2Fb88105155a18c390641C8a73f1402B2BB12',
122
+ cGHS: '0x295B66bE7714458Af45E6A6Ea142A5358A6cA375',
123
+ cJPY: '0x2E51F41238cA36a421C9B8b3e189e8Cc7653FE67',
124
+ cKES: '0x1E0433C1769271ECcF4CFF9FDdD515eefE6CdF92',
125
+ cNGN: '0x4a5b03B8b16122D330306c65e4CA4BC5Dd6511d0',
126
+ cREAL: '0xE4D517785D091D3c54818832dB6094bcc2744545',
127
+ cUSD: '0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1',
128
+ cZAR: '0x1e5b44015Ff90610b54000DAad31C89b3284df4d',
129
+ eXOF: '0xB0FA15e002516d0301884059c0aaC0F0C72b019D',
130
+ PUSO: '0x5E0E3c9419C42a1B04e2525991FB1A2C467AB8bF',
131
+ USDC: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
132
+ USDT: '0xBba91F588d031469ABCCA566FE80fB1Ad8Ee3287',
134
133
  },
135
134
  11142220: {
136
- [TokenSymbol.axlEUROC]: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
137
- [TokenSymbol.axlUSDC]: '0x6285De9DA7C1d329C0451628638908915002d9d1',
138
- [TokenSymbol.cAUD]: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
139
- [TokenSymbol.cCAD]: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
140
- [TokenSymbol.cCHF]: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
141
- [TokenSymbol.cCOP]: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
142
- [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
143
- [TokenSymbol.cEUR]: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
144
- [TokenSymbol.cGBP]: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
145
- [TokenSymbol.cGHS]: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
146
- [TokenSymbol.cJPY]: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
147
- [TokenSymbol.cKES]: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
148
- [TokenSymbol.cNGN]: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
149
- [TokenSymbol.cREAL]: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
150
- [TokenSymbol.cUSD]: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
151
- [TokenSymbol.cZAR]: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
152
- [TokenSymbol.eXOF]: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
153
- [TokenSymbol.PUSO]: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
154
- [TokenSymbol.USDC]: '0xBD63e46Be8eF8D89dFde3054E7b9ECAEb8Ad83e9',
155
- [TokenSymbol.USDT]: '0xCA53d9b72646B254d29EBeEb4c5cde7BB4bb59e0',
135
+ axlEUROC: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
136
+ axlUSDC: '0x6285De9DA7C1d329C0451628638908915002d9d1',
137
+ cAUD: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
138
+ cCAD: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
139
+ cCHF: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
140
+ cCOP: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
141
+ CELO: '0x471EcE3750Da237f93B8E339c536989b8978a438',
142
+ cEUR: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
143
+ cGBP: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
144
+ cGHS: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
145
+ cJPY: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
146
+ cKES: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
147
+ cNGN: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
148
+ cREAL: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
149
+ cUSD: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
150
+ cZAR: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
151
+ eXOF: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
152
+ PUSO: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
153
+ USDC: '0xBD63e46Be8eF8D89dFde3054E7b9ECAEb8Ad83e9',
154
+ USDT: '0xCA53d9b72646B254d29EBeEb4c5cde7BB4bb59e0',
156
155
  },
157
156
  };
158
157
  /**
package/dist/esm/mento.d.ts CHANGED
@@ -2,6 +2,7 @@ import { IBroker } from '@mento-protocol/mento-core-ts';
2
2
  import { BigNumber, BigNumberish, providers, Signer } from 'ethers';
3
3
  import { Address, TradingLimit, TradingLimitsConfig, TradingLimitsState } from './interfaces';
4
4
  import { Identifier } from './constants/addresses';
5
+ import { TokenSymbol } from './constants/tokens';
5
6
  import { TradablePairWithSpread } from './constants/tradablePairs';
6
7
  export interface Exchange {
7
8
  providerAddr: Address;
@@ -14,7 +15,7 @@ export interface Asset {
14
15
  }
15
16
  export interface Token {
16
17
  address: Address;
17
- symbol: string;
18
+ symbol: TokenSymbol;
18
19
  name: string;
19
20
  decimals: number;
20
21
  }
package/dist/esm/utils.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { BigNumberish, providers, Signer } from 'ethers';
2
+ import { TokenSymbol } from './constants';
2
3
  import { Address } from './interfaces';
3
4
  import { TradablePair } from './mento';
4
5
  /**
@@ -25,7 +26,7 @@ export declare function validateSignerOrProvider(signerOrProvider: Signer | prov
25
26
  * @param signerOrProvider an ethers provider or signer
26
27
  * @returns the symbol of the erc20 token
27
28
  */
28
- export declare function getSymbolFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<string>;
29
+ export declare function getSymbolFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<TokenSymbol>;
29
30
  /**
30
31
  * Returns the name of an erc20 token
31
32
  * @param tokenAddr the address of the erc20 token
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mento-protocol/mento-sdk",
3
3
  "description": "Official SDK for interacting with the Mento Protocol",
4
- "version": "1.14.0",
4
+ "version": "1.15.1",
5
5
  "license": "MIT",
6
6
  "author": "Mento Labs",
7
7
  "keywords": [