Cairo: decimals customization

.changeset/swift-eels-repair.md

@@ -0,0 +1,7 @@
+---
+'@openzeppelin/wizard-cairo': minor
+'@openzeppelin/wizard-common': patch
+'@openzeppelin/contracts-mcp': patch
+---
+
+Support decimals customization for ERC20 Cairo contracts

packages/common/CHANGELOG.md

@@ -1,6 +1,9 @@
 # Changelog
 
 
+## 0.1.1 (2025-09-02)
+- Cairo: Add decimals to ERC20 scheme ([#654](https://github.com/OpenZeppelin/contracts-wizard/pull/654))
+
 ## 0.1.0 (2025-08-15)
 
 - Bump minor version for semantic versioning stability ([#631](https://github.com/OpenZeppelin/contracts-wizard/pull/631))

packages/common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/wizard-common",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Common library for OpenZeppelin Contracts Wizard components. Used internally.",
   "license": "AGPL-3.0-only",
   "repository": "https://github.com/OpenZeppelin/contracts-wizard",

packages/common/src/ai/descriptions/cairo.ts

@@ -36,6 +36,7 @@ export const cairoRoyaltyInfoDescriptions = {
 
 export const cairoERC20Descriptions = {
   premint: 'The number of tokens to premint for the deployer.',
+  decimals: 'The number of decimals to use for the contract.',
   votes:
     "Whether to keep track of historical balances for voting in on-chain governance, with a way to delegate one's voting power to a trusted account.",
 };

packages/core/cairo/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 2.1.0 (2025-09-02)
+
+- Support ERC20 decimals customization ([#654](https://github.com/OpenZeppelin/contracts-wizard/pull/654))
 
 ## 2.0.1 (2025-08-20)
 

packages/core/cairo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/wizard-cairo",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "A boilerplate generator to get started with OpenZeppelin Contracts for Cairo",
   "license": "AGPL-3.0-only",
   "repository": "https://github.com/OpenZeppelin/contracts-wizard",

packages/core/cairo/src/erc20.test.ts

@@ -12,6 +12,7 @@ function testERC20(title: string, opts: Partial<ERC20Options>) {
     const c = buildERC20({
       name: 'MyToken',
       symbol: 'MTK',
+      decimals: '18',
       ...opts,
     });
     t.snapshot(printContract(c));
@@ -29,6 +30,7 @@ function testAPIEquivalence(title: string, opts?: ERC20Options) {
         buildERC20({
           name: 'MyToken',
           symbol: 'MTK',
+          decimals: '18',
           ...opts,
         }),
       ),
@@ -69,6 +71,21 @@ testERC20('erc20 premint of 0', {
   premint: '0',
 });
 
+testERC20('erc20 votes, custom decimals', {
+  decimals: '6',
+});
+
+test('erc20 votes, decimals too high', async t => {
+  const error = t.throws(() =>
+    buildERC20({
+      name: 'MyToken',
+      symbol: 'MTK',
+      decimals: '256',
+    }),
+  );
+  t.is((error as OptionsError).messages.decimals, 'Value is greater than u8 max value');
+});
+
 testERC20('erc20 mintable', {
   mintable: true,
   access: 'ownable',
@@ -95,6 +112,7 @@ test('erc20 votes, no name', async t => {
     buildERC20({
       name: 'MyToken',
       symbol: 'MTK',
+      decimals: '18',
       votes: true,
     }),
   );
@@ -106,6 +124,7 @@ test('erc20 votes, empty version', async t => {
     buildERC20({
       name: 'MyToken',
       symbol: 'MTK',
+      decimals: '18',
       votes: true,
       appName: 'MY_DAPP_NAME',
       appVersion: '', // avoids default value of v1
@@ -158,11 +177,12 @@ testERC20('erc20 full upgradeable with roles', {
 
 testAPIEquivalence('erc20 API default');
 
-testAPIEquivalence('erc20 API basic', { name: 'CustomToken', symbol: 'CTK' });
+testAPIEquivalence('erc20 API basic', { name: 'CustomToken', symbol: 'CTK', decimals: '6' });
 
 testAPIEquivalence('erc20 API full upgradeable', {
   name: 'CustomToken',
   symbol: 'CTK',
+  decimals: '6',
   premint: '2000',
   access: 'roles',
   burnable: true,