feat: pnpm migration, contracts precompiles build & npm publish

.github/workflows/slither.yml

@@ -19,9 +19,18 @@ jobs:
         with:
           PATTERNS: |
             **/*.sol
+      - name: Setup Node.js and pnpm
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
       - name: Node dependencies Install
         run: |
-          cd contracts && npm i
+          cd contracts && pnpm install
           cp -r node_modules/@openzeppelin .
       - name: Run Slither Action
         uses: crytic/slither-action@v0.4.0

.github/workflows/tests-compatibility-hardhat.yml

@@ -47,10 +47,16 @@ jobs:
         with:
           version: nightly
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
       - name: Install Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '18'
+          cache: 'pnpm'
 
       - name: Cache Go modules
         uses: actions/cache@v4
@@ -64,9 +70,9 @@ jobs:
         uses: actions/cache@v4
         with:
           path: tests/evm-tools-compatibility/hardhat/node_modules
-          key: ${{ runner.os }}-node-${{ hashFiles('tests/evm-tools-compatibility/hardhat/package-lock.json') }}
+          key: ${{ runner.os }}-pnpm-${{ hashFiles('tests/evm-tools-compatibility/hardhat/pnpm-lock.yaml') }}
           restore-keys: |
-            ${{ runner.os }}-node-
+            ${{ runner.os }}-pnpm-
 
       - name: Build and install evmd
         run: |

.github/workflows/tests-compatibility-viem.yml

@@ -47,10 +47,16 @@ jobs:
         with:
           version: nightly
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
       - name: Install Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '18'
+          cache: 'pnpm'
 
       - name: Cache Go modules
         uses: actions/cache@v4
@@ -64,9 +70,9 @@ jobs:
         uses: actions/cache@v4
         with:
           path: tests/evm-tools-compatibility/viem/node_modules
-          key: ${{ runner.os }}-node-${{ hashFiles('tests/evm-tools-compatibility/viem/package-lock.json') }}
+          key: ${{ runner.os }}-pnpm-${{ hashFiles('tests/evm-tools-compatibility/viem/pnpm-lock.yaml') }}
           restore-keys: |
-            ${{ runner.os }}-node-
+            ${{ runner.os }}-pnpm-
 
       - name: Build and install evmd
         run: |

.github/workflows/tests-compatibility-web3js.yml

@@ -47,10 +47,16 @@ jobs:
         with:
           version: nightly
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
       - name: Install Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '18'
+          cache: 'pnpm'
 
       - name: Cache Go modules
         uses: actions/cache@v4
@@ -64,9 +70,9 @@ jobs:
         uses: actions/cache@v4
         with:
           path: tests/evm-tools-compatibility/web3.js/node_modules
-          key: ${{ runner.os }}-node-${{ hashFiles('tests/evm-tools-compatibility/web3.js/package-lock.json') }}
+          key: ${{ runner.os }}-pnpm-${{ hashFiles('tests/evm-tools-compatibility/web3.js/pnpm-lock.yaml') }}
           restore-keys: |
-            ${{ runner.os }}-node-
+            ${{ runner.os }}-pnpm-
 
       - name: Build and install evmd
         run: |

.gitignore

@@ -25,6 +25,7 @@ yarn.lock
 
 # Node.js
 **/node_modules
+.pnpm-store
 
 # OpenZeppelin contracts
 contracts/@openzeppelin/*

contracts/.gitignore

@@ -1,6 +1,15 @@
 # Compiled contracts
 artifacts/
 
+# Precompiles build output (OpenZeppelin-style dist)
+dist/
+
+# Generated Solidity interface sources (published artifact)
+precompiles/
+
+# Wagmi/tsdown staging (generated inputs)
+.generated/
+
 # Cached files
 cache/
 

contracts/README.md

@@ -0,0 +1,77 @@
+# cosmos-evm-contracts
+
+A collection of smart contracts for the Cosmos EVM blockchain.  
+The published package includes precompile interface sources (`.sol`) and ABIs as typed ESM/CJS modules.
+
+## Installation
+
+```bash
+# pnpm
+pnpm add cosmos-evm-contracts
+
+# npm
+npm install cosmos-evm-contracts
+
+# yarn
+yarn add cosmos-evm-contracts
+```
+
+## Package structure
+
+After installation, use the following paths:
+
+| Path | Description |
+|------|-------------|
+| `cosmos-evm-contracts/precompiles/{module}/{Interface}.sol` | Solidity sources (`.sol`) |
+| `cosmos-evm-contracts/precompiles/{module}/{Interface}` | ABI as typed ESM/CJS modules |
+
+Included precompiles: `bank`, `bech32`, `callbacks`, `common`, `distribution`, `erc20`, `gov`, `ics02`, `ics20`, `slashing`, `staking`, `werc20` (testdata and testutil excluded).
+
+## Usage
+
+### Loading ABI with TypeScript / viem (typed)
+
+Import the named ABI constant so that `functionName`, `args`, and return types are inferred:
+
+```typescript
+import { createPublicClient, http } from "viem";
+import { iBankAbi } from "cosmos-evm-contracts/precompiles/bank/IBank";
+
+const client = createPublicClient({ transport: http() });
+
+// functionName and args are type-checked and autocompleted
+const balances = await client.readContract({
+  address: "0x0000000000000000000000000000000000000804",
+  abi: iBankAbi,
+  functionName: "balances",
+  args: ["0x..."],
+});
+```
+
+Use the same pattern for other precompiles, e.g. `distributionIAbi` from `precompiles/distribution/DistributionI`, `stakingIAbi` from `precompiles/staking/StakingI`, etc.
+
+### Using interfaces in Hardhat
+
+Import by package path in your contract:
+
+```solidity
+import "cosmos-evm-contracts/precompiles/bank/IBank.sol";
+```
+
+### Using interfaces in Foundry
+
+Add the following to `remappings.txt` for shorter import paths:
+
+```
+cosmos-evm-contracts/=node_modules/cosmos-evm-contracts/precompiles/
+```
+
+```solidity
+import "cosmos-evm-contracts/bank/IBank.sol";
+```
+
+### Path reference
+
+- Interface ABI: `cosmos-evm-contracts/precompiles/{module}/{Interface}` (typed ESM/CJS module)
+  e.g. `precompiles/staking/StakingI`
+- Common types: `cosmos-evm-contracts/precompiles/common/Types.sol` (structs only, no ABI)

contracts/hardhat.config.js

@@ -12,6 +12,17 @@ export default {
           viaIR: true,
         },
       },
+      // This version is required to compile @account-abstraction/contracts (PackedUserOperation, IAccount use ^0.8.28).
+      {
+        version: "0.8.28",
+        settings: {
+          optimizer: {
+            enabled: true,
+            runs: 100,
+          },
+          viaIR: true,
+        },
+      },
       // This version is required to compile the werc9 contract.
       {
         version: "0.4.22",