@mento-protocol/mento-sdk 1.18.0 → 1.19.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 (117) hide show
  1. package/dist/cjs/ChainClient.d.ts +9 -0
  2. package/dist/cjs/ChainClient.js +58 -0
  3. package/dist/cjs/TestChainClient.d.ts +7 -0
  4. package/dist/cjs/TestChainClient.js +41 -0
  5. package/dist/cjs/constants/addresses.d.ts +4 -0
  6. package/dist/cjs/constants/addresses.js +59 -0
  7. package/dist/cjs/constants/currencies.d.ts +5 -0
  8. package/dist/cjs/constants/currencies.js +29 -0
  9. package/dist/cjs/constants/index.d.ts +4 -0
  10. package/dist/cjs/constants/index.js +20 -0
  11. package/dist/cjs/constants/tokens.11142220.d.ts +2 -0
  12. package/dist/cjs/constants/tokens.11142220.js +128 -0
  13. package/dist/cjs/constants/tokens.42220.d.ts +2 -0
  14. package/dist/cjs/constants/tokens.42220.js +128 -0
  15. package/dist/cjs/constants/tokens.d.ts +50 -0
  16. package/dist/cjs/constants/tokens.js +155 -0
  17. package/dist/cjs/constants/tradablePairs.11142220.d.ts +2 -0
  18. package/dist/cjs/constants/tradablePairs.11142220.js +7391 -0
  19. package/dist/cjs/constants/tradablePairs.42220.d.ts +2 -0
  20. package/dist/cjs/constants/tradablePairs.42220.js +7391 -0
  21. package/dist/cjs/constants/tradablePairs.d.ts +16 -0
  22. package/dist/cjs/constants/tradablePairs.js +53 -0
  23. package/dist/cjs/enums/chainId.d.ts +4 -0
  24. package/dist/cjs/enums/chainId.js +8 -0
  25. package/dist/cjs/enums/index.d.ts +3 -0
  26. package/dist/cjs/enums/index.js +19 -0
  27. package/dist/cjs/enums/proposalState.d.ts +10 -0
  28. package/dist/cjs/enums/proposalState.js +14 -0
  29. package/dist/cjs/enums/tradingMode.d.ts +17 -0
  30. package/dist/cjs/enums/tradingMode.js +21 -0
  31. package/dist/cjs/governance.d.ts +62 -0
  32. package/dist/cjs/governance.js +151 -0
  33. package/dist/cjs/index.d.ts +7 -0
  34. package/dist/cjs/index.js +23 -0
  35. package/dist/cjs/interfaces/IChainClient.d.ts +6 -0
  36. package/dist/cjs/interfaces/IChainClient.js +2 -0
  37. package/dist/cjs/interfaces/index.d.ts +4 -0
  38. package/dist/cjs/interfaces/index.js +20 -0
  39. package/dist/cjs/interfaces/tradingLimit.d.ts +7 -0
  40. package/dist/cjs/interfaces/tradingLimit.js +2 -0
  41. package/dist/cjs/interfaces/tradingLimitsConfig.d.ts +10 -0
  42. package/dist/cjs/interfaces/tradingLimitsConfig.js +2 -0
  43. package/dist/cjs/interfaces/tradingLimitsState.d.ts +9 -0
  44. package/dist/cjs/interfaces/tradingLimitsState.js +2 -0
  45. package/dist/cjs/limits.d.ts +33 -0
  46. package/dist/cjs/limits.js +130 -0
  47. package/dist/cjs/mento.d.ts +287 -0
  48. package/dist/cjs/mento.js +699 -0
  49. package/dist/cjs/routeUtils.d.ts +304 -0
  50. package/dist/cjs/routeUtils.js +372 -0
  51. package/dist/cjs/types/contractAddressMap.d.ts +4 -0
  52. package/dist/cjs/types/contractAddressMap.js +2 -0
  53. package/dist/cjs/types/contractAddresses.d.ts +23 -0
  54. package/dist/cjs/types/contractAddresses.js +2 -0
  55. package/dist/cjs/types/index.d.ts +2 -0
  56. package/dist/cjs/types/index.js +18 -0
  57. package/dist/cjs/utils.d.ts +80 -0
  58. package/dist/cjs/utils.js +177 -0
  59. package/dist/esm/ChainClient.d.ts +9 -0
  60. package/dist/esm/ChainClient.js +54 -0
  61. package/dist/esm/TestChainClient.d.ts +7 -0
  62. package/dist/esm/TestChainClient.js +37 -0
  63. package/dist/esm/constants/addresses.d.ts +4 -0
  64. package/dist/esm/constants/addresses.js +55 -0
  65. package/dist/esm/constants/currencies.d.ts +5 -0
  66. package/dist/esm/constants/currencies.js +26 -0
  67. package/dist/esm/constants/index.d.ts +4 -0
  68. package/dist/esm/constants/index.js +4 -0
  69. package/dist/esm/constants/tokens.11142220.d.ts +2 -0
  70. package/dist/esm/constants/tokens.11142220.js +125 -0
  71. package/dist/esm/constants/tokens.42220.d.ts +2 -0
  72. package/dist/esm/constants/tokens.42220.js +125 -0
  73. package/dist/esm/constants/tokens.d.ts +50 -0
  74. package/dist/esm/constants/tokens.js +127 -0
  75. package/dist/esm/constants/tradablePairs.11142220.d.ts +2 -0
  76. package/dist/esm/constants/tradablePairs.11142220.js +7388 -0
  77. package/dist/esm/constants/tradablePairs.42220.d.ts +2 -0
  78. package/dist/esm/constants/tradablePairs.42220.js +7388 -0
  79. package/dist/esm/constants/tradablePairs.d.ts +16 -0
  80. package/dist/esm/constants/tradablePairs.js +26 -0
  81. package/dist/esm/enums/chainId.d.ts +4 -0
  82. package/dist/esm/enums/chainId.js +5 -0
  83. package/dist/esm/enums/index.d.ts +3 -0
  84. package/dist/esm/enums/index.js +3 -0
  85. package/dist/esm/enums/proposalState.d.ts +10 -0
  86. package/dist/esm/enums/proposalState.js +11 -0
  87. package/dist/esm/enums/tradingMode.d.ts +17 -0
  88. package/dist/esm/enums/tradingMode.js +18 -0
  89. package/dist/esm/governance.d.ts +62 -0
  90. package/dist/esm/governance.js +147 -0
  91. package/dist/esm/index.d.ts +7 -0
  92. package/dist/esm/index.js +7 -0
  93. package/dist/esm/interfaces/IChainClient.d.ts +6 -0
  94. package/dist/esm/interfaces/IChainClient.js +1 -0
  95. package/dist/esm/interfaces/index.d.ts +4 -0
  96. package/dist/esm/interfaces/index.js +4 -0
  97. package/dist/esm/interfaces/tradingLimit.d.ts +7 -0
  98. package/dist/esm/interfaces/tradingLimit.js +1 -0
  99. package/dist/esm/interfaces/tradingLimitsConfig.d.ts +10 -0
  100. package/dist/esm/interfaces/tradingLimitsConfig.js +1 -0
  101. package/dist/esm/interfaces/tradingLimitsState.d.ts +9 -0
  102. package/dist/esm/interfaces/tradingLimitsState.js +1 -0
  103. package/dist/esm/limits.d.ts +33 -0
  104. package/dist/esm/limits.js +123 -0
  105. package/dist/esm/mento.d.ts +287 -0
  106. package/dist/esm/mento.js +671 -0
  107. package/dist/esm/routeUtils.d.ts +304 -0
  108. package/dist/esm/routeUtils.js +362 -0
  109. package/dist/esm/types/contractAddressMap.d.ts +4 -0
  110. package/dist/esm/types/contractAddressMap.js +1 -0
  111. package/dist/esm/types/contractAddresses.d.ts +23 -0
  112. package/dist/esm/types/contractAddresses.js +1 -0
  113. package/dist/esm/types/index.d.ts +2 -0
  114. package/dist/esm/types/index.js +2 -0
  115. package/dist/esm/utils.d.ts +80 -0
  116. package/dist/esm/utils.js +162 -0
  117. package/package.json +1 -1
@@ -0,0 +1,125 @@
1
+ // This file is auto-generated. Do not edit manually.
2
+ // Generated on 2025-12-16T15:12:19.767Z
3
+ import { TokenSymbol } from '../mento';
4
+ export const tokens42220 = [
5
+ {
6
+ address: '0x7175504C455076F15c04A2F90a8e352281F492F9',
7
+ symbol: TokenSymbol.AUDm,
8
+ name: 'Mento Australian Dollar',
9
+ decimals: 18,
10
+ },
11
+ {
12
+ address: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
13
+ symbol: TokenSymbol.axlEUROC,
14
+ name: 'Axelar Wrapped EUROC',
15
+ decimals: 6,
16
+ },
17
+ {
18
+ address: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
19
+ symbol: TokenSymbol.axlUSDC,
20
+ name: 'Axelar Wrapped USDC',
21
+ decimals: 6,
22
+ },
23
+ {
24
+ address: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
25
+ symbol: TokenSymbol.BRLm,
26
+ name: 'Mento Brazilian Real',
27
+ decimals: 18,
28
+ },
29
+ {
30
+ address: '0xff4Ab19391af240c311c54200a492233052B6325',
31
+ symbol: TokenSymbol.CADm,
32
+ name: 'Mento Canadian Dollar',
33
+ decimals: 18,
34
+ },
35
+ {
36
+ address: '0x471EcE3750Da237f93B8E339c536989b8978a438',
37
+ symbol: TokenSymbol.CELO,
38
+ name: 'Celo native asset',
39
+ decimals: 18,
40
+ },
41
+ {
42
+ address: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
43
+ symbol: TokenSymbol.CHFm,
44
+ name: 'Mento Swiss Franc',
45
+ decimals: 18,
46
+ },
47
+ {
48
+ address: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
49
+ symbol: TokenSymbol.COPm,
50
+ name: 'Mento Colombian Peso',
51
+ decimals: 18,
52
+ },
53
+ {
54
+ address: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
55
+ symbol: TokenSymbol.EURm,
56
+ name: 'Mento Euro',
57
+ decimals: 18,
58
+ },
59
+ {
60
+ address: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
61
+ symbol: TokenSymbol.GBPm,
62
+ name: 'Mento British Pound',
63
+ decimals: 18,
64
+ },
65
+ {
66
+ address: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
67
+ symbol: TokenSymbol.GHSm,
68
+ name: 'Mento Ghanaian Cedi',
69
+ decimals: 18,
70
+ },
71
+ {
72
+ address: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
73
+ symbol: TokenSymbol.JPYm,
74
+ name: 'Mento Japanese Yen',
75
+ decimals: 18,
76
+ },
77
+ {
78
+ address: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
79
+ symbol: TokenSymbol.KESm,
80
+ name: 'Mento Kenyan Shilling',
81
+ decimals: 18,
82
+ },
83
+ {
84
+ address: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
85
+ symbol: TokenSymbol.NGNm,
86
+ name: 'Mento Nigerian Naira',
87
+ decimals: 18,
88
+ },
89
+ {
90
+ address: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
91
+ symbol: TokenSymbol.PHPm,
92
+ name: 'Mento Philippine Peso',
93
+ decimals: 18,
94
+ },
95
+ {
96
+ address: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
97
+ symbol: TokenSymbol.USD_,
98
+ name: 'Tether USD',
99
+ decimals: 6,
100
+ },
101
+ {
102
+ address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
103
+ symbol: TokenSymbol.USDC,
104
+ name: 'USDC',
105
+ decimals: 6,
106
+ },
107
+ {
108
+ address: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
109
+ symbol: TokenSymbol.USDm,
110
+ name: 'Mento Dollar',
111
+ decimals: 18,
112
+ },
113
+ {
114
+ address: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
115
+ symbol: TokenSymbol.XOFm,
116
+ name: 'Mento West African CFA franc',
117
+ decimals: 18,
118
+ },
119
+ {
120
+ address: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
121
+ symbol: TokenSymbol.ZARm,
122
+ name: 'Mento South African Rand',
123
+ decimals: 18,
124
+ },
125
+ ];
@@ -0,0 +1,50 @@
1
+ import { Token } from '../mento';
2
+ /**
3
+ * Gets cached tokens for a specific chain ID
4
+ * @param chainId - The chain ID to get cached tokens for
5
+ * @returns Promise resolving to the cached tokens or undefined if not available
6
+ */
7
+ export declare function getCachedTokens(chainId: number): Promise<readonly Token[] | undefined>;
8
+ /**
9
+ * Synchronously gets cached tokens for a specific chain ID
10
+ * Note: This function throws if no cached tokens are available.
11
+ * Use getCachedTokens() for async loading or when you want to handle missing cache gracefully.
12
+ *
13
+ * @param chainId - The chain ID to get cached tokens for
14
+ * @returns The cached tokens
15
+ * @throws Error if no cached tokens are available for the chain
16
+ */
17
+ export declare function getCachedTokensSync(chainId: number): readonly Token[];
18
+ /**
19
+ * Token symbol enum for type-safe access across all chains
20
+ * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
21
+ */
22
+ export declare enum TokenSymbol {
23
+ AUDm = "AUDm",
24
+ BRLm = "BRLm",
25
+ CADm = "CADm",
26
+ CELO = "CELO",
27
+ CHFm = "CHFm",
28
+ COPm = "COPm",
29
+ EURm = "EURm",
30
+ GBPm = "GBPm",
31
+ GHSm = "GHSm",
32
+ JPYm = "JPYm",
33
+ KESm = "KESm",
34
+ NGNm = "NGNm",
35
+ PHPm = "PHPm",
36
+ USDC = "USDC",
37
+ USDm = "USDm",
38
+ USD_ = "USD\u20AE",
39
+ XOFm = "XOFm",
40
+ ZARm = "ZARm",
41
+ axlEUROC = "axlEUROC",
42
+ axlUSDC = "axlUSDC"
43
+ }
44
+ /**
45
+ * Token addresses mapped by chain ID and symbol
46
+ * Use this for type-safe token address lookups
47
+ */
48
+ export declare const TOKEN_ADDRESSES_BY_CHAIN: {
49
+ [chainId: number]: Partial<Record<TokenSymbol, string>>;
50
+ };
@@ -0,0 +1,127 @@
1
+ // This file is auto-generated. Do not edit manually.
2
+ // Generated on 2025-12-16T15:12:28.484Z
3
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
4
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
5
+ return new (P || (P = Promise))(function (resolve, reject) {
6
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
7
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
8
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
9
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
10
+ });
11
+ };
12
+ /**
13
+ * Gets cached tokens for a specific chain ID
14
+ * @param chainId - The chain ID to get cached tokens for
15
+ * @returns Promise resolving to the cached tokens or undefined if not available
16
+ */
17
+ export function getCachedTokens(chainId) {
18
+ return __awaiter(this, void 0, void 0, function* () {
19
+ switch (chainId) {
20
+ case 42220:
21
+ return yield import('./tokens.42220').then((module) => module.tokens42220);
22
+ case 11142220:
23
+ return yield import('./tokens.11142220').then((module) => module.tokens11142220);
24
+ default:
25
+ return undefined;
26
+ }
27
+ });
28
+ }
29
+ /**
30
+ * Synchronously gets cached tokens for a specific chain ID
31
+ * Note: This function throws if no cached tokens are available.
32
+ * Use getCachedTokens() for async loading or when you want to handle missing cache gracefully.
33
+ *
34
+ * @param chainId - The chain ID to get cached tokens for
35
+ * @returns The cached tokens
36
+ * @throws Error if no cached tokens are available for the chain
37
+ */
38
+ export function getCachedTokensSync(chainId) {
39
+ switch (chainId) {
40
+ case 42220:
41
+ // eslint-disable-next-line @typescript-eslint/no-var-requires
42
+ return require('./tokens.42220').tokens42220;
43
+ case 11142220:
44
+ // eslint-disable-next-line @typescript-eslint/no-var-requires
45
+ return require('./tokens.11142220').tokens11142220;
46
+ default:
47
+ throw new Error(`No cached tokens available for chain ID ${chainId}. ` +
48
+ `Supported chains: 42220 (Celo), 11142220 (Celo Sepolia)`);
49
+ }
50
+ }
51
+ /**
52
+ * Token symbol enum for type-safe access across all chains
53
+ * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
54
+ */
55
+ export var TokenSymbol;
56
+ (function (TokenSymbol) {
57
+ TokenSymbol["AUDm"] = "AUDm";
58
+ TokenSymbol["BRLm"] = "BRLm";
59
+ TokenSymbol["CADm"] = "CADm";
60
+ TokenSymbol["CELO"] = "CELO";
61
+ TokenSymbol["CHFm"] = "CHFm";
62
+ TokenSymbol["COPm"] = "COPm";
63
+ TokenSymbol["EURm"] = "EURm";
64
+ TokenSymbol["GBPm"] = "GBPm";
65
+ TokenSymbol["GHSm"] = "GHSm";
66
+ TokenSymbol["JPYm"] = "JPYm";
67
+ TokenSymbol["KESm"] = "KESm";
68
+ TokenSymbol["NGNm"] = "NGNm";
69
+ TokenSymbol["PHPm"] = "PHPm";
70
+ TokenSymbol["USDC"] = "USDC";
71
+ TokenSymbol["USDm"] = "USDm";
72
+ TokenSymbol["USD_"] = "USD\u20AE";
73
+ TokenSymbol["XOFm"] = "XOFm";
74
+ TokenSymbol["ZARm"] = "ZARm";
75
+ TokenSymbol["axlEUROC"] = "axlEUROC";
76
+ TokenSymbol["axlUSDC"] = "axlUSDC";
77
+ })(TokenSymbol || (TokenSymbol = {}));
78
+ /**
79
+ * Token addresses mapped by chain ID and symbol
80
+ * Use this for type-safe token address lookups
81
+ */
82
+ export const TOKEN_ADDRESSES_BY_CHAIN = {
83
+ 42220: {
84
+ AUDm: '0x7175504C455076F15c04A2F90a8e352281F492F9',
85
+ axlEUROC: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
86
+ axlUSDC: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
87
+ BRLm: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
88
+ CADm: '0xff4Ab19391af240c311c54200a492233052B6325',
89
+ CELO: '0x471EcE3750Da237f93B8E339c536989b8978a438',
90
+ CHFm: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
91
+ COPm: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
92
+ EURm: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
93
+ GBPm: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
94
+ GHSm: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
95
+ JPYm: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
96
+ KESm: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
97
+ NGNm: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
98
+ PHPm: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
99
+ 'USD₮': '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
100
+ USDC: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
101
+ USDm: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
102
+ XOFm: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
103
+ ZARm: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
104
+ },
105
+ 11142220: {
106
+ AUDm: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
107
+ axlEUROC: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
108
+ axlUSDC: '0x6285De9DA7C1d329C0451628638908915002d9d1',
109
+ BRLm: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
110
+ CADm: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
111
+ CELO: '0x471EcE3750Da237f93B8E339c536989b8978a438',
112
+ CHFm: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
113
+ COPm: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
114
+ EURm: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
115
+ GBPm: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
116
+ GHSm: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
117
+ JPYm: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
118
+ KESm: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
119
+ NGNm: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
120
+ PHPm: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
121
+ 'USD₮': '0xd077A400968890Eacc75cdc901F0356c943e4fDb',
122
+ USDC: '0x01C5C0122039549AD1493B8220cABEdD739BC44E',
123
+ USDm: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
124
+ XOFm: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
125
+ ZARm: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
126
+ },
127
+ };
@@ -0,0 +1,2 @@
1
+ import { TradablePairWithSpread } from './tradablePairs';
2
+ export declare const tradablePairs11142220: TradablePairWithSpread[];