solidity gringotts

[codchen]

Summary

Ports the CosmWasm Gringotts vesting contract to Solidity for deployment on Sei's EVM. Uses native SEI tokens and integrates directly with Sei's staking and distribution precompiles.

Key Features

• Native SEI Support: Works with native SEI tokens (not ERC20), sent via msg.value during deployment
• Sei Precompile Integration: Direct integration with Sei's staking (0x1005) and distribution (0x1007) precompiles
• Upgradeable Contract: UUPS proxy pattern with multi-sig admin approval for upgrades
• Migration Tooling: Scripts to export state from existing CosmWasm contracts and deploy Solidity equivalents

Changes

New Files:

• solidity/contracts/Gringotts.sol - Main upgradeable vesting contract
• solidity/contracts/GringottsFactory.sol - Factory for deploying proxy instances
• solidity/interfaces/IStaking.sol - Sei staking precompile interface
• solidity/interfaces/IDistribution.sol - Sei distribution precompile interface
• solidity/contracts/mocks/ - Mock contracts for testing
• solidity/scripts/migration/ - Migration scripts for CosmWasm → Solidity
• solidity/test/Gringotts.test.js - Test suite (15 passing)

Configuration:

• solidity/package.json - Hardhat project with dependencies
• solidity/hardhat.config.js - Compiler settings (0.8.24, viaIR, Sei networks)
• .gitignore - Added node_modules/ and **/cache

Upgrade Process

Contract upgrades require multi-sig admin approval:

1. Admin calls proposeUpgrade(newImplementation)
2. Other admins vote via voteProposal(proposalId)
3. Once threshold reached, admin calls processProposal(proposalId)

Migration from CosmWasm

Export existing contract state

node scripts/migration/export-cosmwasm.js sei1contract... --output export.json

Convert addresses (sei1... → 0x...)

seid q evm sei-addr sei1admin...

Deploy to Sei EVM

EXPORT_FILE=export.json npx hardhat run scripts/migration/deploy-from-export.js --network sei

---

Note

High Risk
High risk because this introduces new upgradeable Solidity contracts that custody and transfer native SEI, interact with Sei staking/distribution/gov precompiles, and implement admin-controlled upgrade/emergency-withdraw flows.

Overview
Adds a new solidity/ Hardhat project implementing Gringotts as an upgradeable (UUPS) native-SEI vesting contract with admin multi-sig proposals, operator-only staking actions, reward withdrawals via Sei precompiles, and an admin-approved emergency withdrawal path.

Introduces GringottsFactory for deploying initialized ERC1967 proxies, Sei precompile interfaces (IStaking, IDistribution, IGov), and mock precompile contracts for testing; adds docs and deployment/migration scripts.

Wires up CI via a new Solidity GitHub Actions workflow to npm ci, compile, and run tests (with a Sei docker image), updates .gitignore for Node artifacts, and bumps the Rust crate version to 0.1.11.

^{Reviewed by Cursor Bugbot for commit 2d4e958. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2d4e958. Configure here.}

[cursor]

Reward conversion ignores coin decimals field

Low Severity

_coinAmountToWei divides coin.amount by the hardcoded DECIMAL_USEI_PER_WEI (1e6) without consulting coin.decimals or coin.denom. This produces the correct result only when the precompile returns usei with exactly 18-decimal precision. If the distribution precompile ever returns a coin with a different decimals value or a non-usei denomination, the conversion silently produces an incorrect result, leading to over- or under-counting of staking rewards in all reward-tracking paths.

 

^{Reviewed by Cursor Bugbot for commit 2d4e958. Configure here.}