🦀 Ink! Smart Contracts Collection

A comprehensive collection of ink! smart contracts and modern frontend applications built for the Polkadot ecosystem. This repository showcases various contract implementations, from basic token standards to complex governance systems, along with production-ready React frontends for seamless user interaction.

🧭 Quick Navigation

Smart Contracts

🏛️ Governance Contract - DAO governance system (README)
🪙 PSP22 Boilerplate - Token standard implementation (README)
🏢 Advanced Token - Enterprise token features (README)
✅ Simple Todo - Vec-based todo list (README)
✅ Todo Map - Mapping-based todo list (README)
🪙 v6 PSP22 - Modern token implementation (README)
🐷 Piggy Bank - Savings contract (README)

Frontend Applications

🏛️ Governance DApp - Production-ready governance UI (README)
🪙 ERC20 Frontend - Token interaction interface (README)
📚 Web3Bridge Curriculum - Learning materials

📁 Project Structure

📦 Smart Contracts (Rust + ink! v6)

Contract	Description	Technology	Link
🏛️ Governance	DAO Governance System	ink! v6.0.0-alpha.4	📁 governance/
🪙 PSP22 Boilerplate	PSP22 Token Standard	ink! v5.1.1	📁 ink-bootcamp-erc20-boilerplate/
🏢 Advanced Token	ERC-20 Style Token	ink! v5.1.1	📁 Token/
✅ Simple Todo	Vec-based Todo List	ink! v5.1.1	📁 todo/
✅ Todo Map	Mapping-based Todo List	ink! v5.1.1	📁 todo_map/
🪙 v6 PSP22	Modern PSP22 Token	ink! v6.0.0-alpha.4	📁 v6psp20/
🐷 Piggy Bank	Savings Contract	ink! v6.0.0-alpha.4	📁 v6psp20piggybank/

🎨 Frontend Applications

Application	Description	Technology	Link
🏛️ Governance DApp	DAO Governance Frontend	Next.js 15 + React 19	📁 governance-dapp/
🪙 ERC20 Frontend	Token Interaction UI	Next.js 15 + React 19	📁 erc20fe/
📚 Web3Bridge	Learning Materials	React + Vite	📁 web3bridge-curriculum/

📄 Documentation

Document	Description	Link
📖 Main README	This comprehensive guide	📄 README.md

🚀 Quick Start

Prerequisites

Before you begin, ensure you have the following installed:

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Add WebAssembly target
rustup target add wasm32-unknown-unknown

# Install cargo-contract
cargo install cargo-contract --force

# Install substrate-contracts-node (for local testing)
cargo install contracts-node --git https://github.com/paritytech/substrate-contracts-node.git

# Install Node.js (for frontend development)
# Visit: https://nodejs.org/

Local Development Setup

Start Local Node

# In a separate terminal
substrate-contracts-node --dev

Build Any Contract

cd <contract-directory>
cargo contract build --release

Deploy Contract

cargo contract instantiate --constructor new --suri //Alice --skip-confirm

Run Frontend

cd frontend/governance-dapp
npm install
npm run dev

📦 Smart Contracts

🏛️ Governance Contract

Location: governance/ Technology: ink! v6.0.0-alpha.4

A comprehensive DAO governance system implementing decentralized decision-making:

Core Features

Proposal Management: Create, vote on, and execute proposals
Voting System: Multi-option voting with customizable parameters
Quorum Requirements: Configurable participation thresholds
Execution Delays: Time-locked execution for security
Voter Registration: Permission-based voting participation
Treasury Management: Fund allocation and spending controls

Key Functions

// Proposal Management
create_proposal(title, description, proposal_type, governance_params, voting_options) -> u32
get_proposal(proposal_id) -> Option<Proposal>
get_all_proposal_ids() -> Vec<u32>

// Voting System
vote(proposal_id, option_index) -> Result<()>
get_user_vote(proposal_id, user) -> Option<Vote>
has_reached_quorum(proposal_id) -> Option<bool>
get_detailed_results(proposal_id) -> Option<Vec<(String, u128)>>

// Voter Management
register_voter() -> Result<()>
is_voter(account) -> bool
get_total_voters() -> u32

// Status Management
update_proposal_status(proposal_id) -> Result<()>
execute_proposal(proposal_id) -> Result<()>

Data Structures

pub struct Proposal {
    pub id: u32,
    pub title: String,
    pub description: String,
    pub proposal_type: ProposalType,        // Treasury, Governance, Technical, Other
    pub governance_params: GovernanceParameters,
    pub voting_options: VotingOptions,      // Custom voting choices
    pub proposer: H160,
    pub created_at: u32,                    // Block number
    pub voting_end: u32,                    // Block number
    pub execution_time: u32,                // Block number
    pub status: ProposalStatus,             // Active, Passed, Rejected, Executed, Expired
    pub vote_counts: Vec<u128>,             // Votes per option
    pub total_voters: u32,
}

pub struct Vote {
    pub voter: H160,
    pub choice: VoteChoice,
    pub timestamp: u32,
    pub weight: u128,
}

🪙 PSP22 Token Contracts

ink-bootcamp-erc20-boilerplate

Location: ink-bootcamp-erc20-boilerplate/ Technology: ink! v5.1.1

A complete PSP22 token implementation with all standard features:

✅ PSP22 Core - Transfer, approve, and allowance functionality
✅ PSP22 Metadata - Token name, symbol, and decimals
✅ PSP22 Mintable - Mint new tokens
✅ PSP22 Burnable - Burn existing tokens
✅ Safe Arithmetic - Overflow protection
✅ Comprehensive Error Handling

Token Contract

Location: Token/ Technology: ink! v5.1.1

Advanced ERC-20 style token with enterprise features:

Core Functionality: Transfer, approve, allowance
Burn Mechanism: Users can burn their tokens
Pausable: Emergency pause functionality
Blacklist: Address blacklisting capability
Batch Operations: Multi-recipient transfers
Owner Controls: Administrative functions

v6psp20

Location: v6psp20/ Technology: ink! v6.0.0-alpha.4

Modern PSP22 token implementation using ink! v6 with:

Latest ink! v6 features and optimizations
Enhanced storage patterns
Improved error handling
Polkadot VM compatibility

🐷 Piggy Bank Contract

Location: v6psp20piggybank/ Technology: ink! v6.0.0-alpha.4

A savings contract that allows users to:

Deposit Tokens: Save PSP22 tokens
Set Goals: Define savings targets
Withdraw: Retrieve funds (with restrictions)
Break Piggy Bank: Emergency withdrawal
Goal Tracking: Monitor progress

✅ Todo List Contracts

Simple Todo

Location: todo/ Technology: ink! v5.1.1

Basic todo list implementation using Vec storage:

Add tasks
Mark tasks as complete
Get all tasks
Delete tasks
Simple storage pattern

Todo with Mapping

Location: todo_map/ Technology: ink! v5.1.1

Optimized todo list using Mapping storage:

More efficient storage
Individual task access
Better gas optimization
Scalable design

🎨 Frontend Applications

🏛️ DAO Governance DApp

Location: frontend/governance-dapp/ Technology: Next.js 15.5.3 + React 19 + TypeScript

A production-ready governance frontend with real contract integration:

Features

Real Contract Integration: Direct interaction with deployed governance contract
Wallet Connection: Support for multiple Polkadot wallets
Proposal Management: Create, view, and vote on proposals
Voter Registration: Join governance participation
Real-time Updates: Live data from blockchain
Responsive Design: Mobile-first UI with Tailwind CSS
Type Safety: Full TypeScript integration

Key Components

src/
├── app/                    # Next.js App Router pages
│   ├── page.tsx           # Home page with stats
│   ├── proposals/         # Proposal listing and voting
│   ├── create/            # Create new proposals
│   ├── dashboard/         # User dashboard
│   └── voters/            # Voter statistics
├── components/            # Reusable UI components
│   ├── create-proposal.tsx
│   ├── governance-dashboard.tsx
│   └── shared/            # Shared components
├── contexts/              # React Context providers
│   ├── governance-client.tsx  # Contract interaction
│   └── types.ts           # TypeScript definitions
└── lib/                   # Utilities and types
    └── governance-types.ts

Technology Stack

Framework: Next.js 15.5.3 with App Router
UI Library: Radix UI + Tailwind CSS
Web3 Integration: Polkadot API + Typink
State Management: React Context API
Type Safety: TypeScript 5.9.2
Wallet Integration: Talisman Connect

ERC20 Frontend

Location: frontend/erc20fe/ Technology: Next.js 15.5.4 + React 19

Modern Next.js application for token interaction:

Framework: Next.js 15.5.4 with TypeScript
Styling: Tailwind CSS
Web3 Integration: Polkadot.js API
Features:
- Wallet connection
- Token balance display
- Transfer functionality
- Transaction history
- Real-time updates

Web3Bridge Curriculum

Location: frontend/web3bridge-curriculum/ Technology: React + Vite

Educational materials and demos:

ink-papi-demo: React + Vite demo application
Learning Resources: Comprehensive tutorials
Contract Examples: Step-by-step implementations
Best Practices: Development guidelines

🛠️ Development Workflow

Building Contracts

# Development build (faster, with debug info)
cargo contract build

# Production build (optimized, smaller size)
cargo contract build --release

Testing

# Run unit tests
cargo test

# Run integration tests
cargo test --features e2e-tests

Frontend Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

Deployment Options

1. Local Development

substrate-contracts-node --dev
cargo contract instantiate --constructor new --suri //Alice

2. Contracts UI

Visit: https://contracts-ui.substrate.io/

3. Polkadot.js Apps

Visit: https://polkadot.js.org/apps/

4. Test Networks

Rococo Contracts: wss://rococo-contracts-rpc.polkadot.io
Aleph Zero Testnet: wss://ws.test.azero.dev

📚 Contract APIs

Common Functions

Most contracts implement these standard functions:

// Token contracts
total_supply() -> Balance
balance_of(owner: AccountId) -> Balance
transfer(to: AccountId, value: Balance) -> Result<(), Error>
approve(spender: AccountId, value: Balance) -> Result<(), Error>

// Todo contracts
add_task(description: String) -> u32
complete_task(id: u32) -> bool
get_task(id: u32) -> Option<Task>
get_all_tasks() -> Vec<Task>

// Governance contracts
create_proposal(title: String, description: String, ...) -> u32
vote(proposal_id: u32, option_index: u32) -> Result<(), Error>
execute_proposal(proposal_id: u32) -> Result<(), Error>
register_voter() -> Result<(), Error>

🔧 Configuration

Cargo.toml Dependencies

All contracts use these core dependencies:

ink! v5 Contracts:

[dependencies]
ink = { version = "5.1.1", default-features = false }
scale = { package = "parity-scale-codec", version = "3", default-features = false, features = ["derive"] }
scale-info = { version = "2.11", default-features = false, features = ["derive"] }

ink! v6 Contracts:

[dependencies]
ink = { git = "https://github.com/use-ink/ink", tag = "v6.0.0-alpha.4", version = "6.0.0-alpha.4", default-features = false, features = ["unstable-hostfn"] }
scale = { package = "parity-scale-codec", version = "3", default-features = false, features = ["derive"] }
scale-info = { version = "2", default-features = false, features = ["derive"] }

Frontend Dependencies

Governance DApp:

{
  "dependencies": {
    "next": "^15.5.3",
    "react": "^19.1.1",
    "polkadot-api": "^1.20.0",
    "@talismn/connect-wallets": "^1.2.8",
    "typink": "^0.5.0",
    "tailwindcss": "^4.1.13"
  }
}

🧪 Testing

Unit Tests

cargo test

Integration Tests

cargo test --features e2e-tests

Frontend Tests

cd frontend/governance-dapp
npm test

🚨 Troubleshooting

Common Issues

"CodeRejected" Error

# Install compatible node version
cargo install contracts-node --git https://github.com/paritytech/substrate-contracts-node.git --tag v0.47.0 --locked --force

"Cannot connect to node"

# Check if node is running
substrate-contracts-node --dev

# Verify node health
curl -H "Content-Type: application/json" \
  -d '{"id":1, "jsonrpc":"2.0", "method": "system_health"}' \
  http://localhost:9944

"Insufficient funds"

Use pre-funded test accounts: //Alice, //Bob, //Charlie
Request funds from testnet faucet

Frontend Build Issues

# Clear Next.js cache
rm -rf .next

# Reinstall dependencies
rm -rf node_modules package-lock.json
npm install

# Rebuild
npm run build

📖 Learning Resources

Documentation

Tools

Community

🏗️ Architecture Overview

Smart Contract Stack

┌─────────────────────────────────────┐
│           Frontend Apps             │
│    (Next.js, React, TypeScript)    │
├─────────────────────────────────────┤
│         Polkadot API               │
│      (Web3 Integration Layer)      │
├─────────────────────────────────────┤
│        Substrate Runtime           │
│      (Blockchain Infrastructure)   │
├─────────────────────────────────────┤
│         ink! Contracts             │
│    (Smart Contract Layer)          │
└─────────────────────────────────────┘

Contract Interaction Flow

User → Frontend → Polkadot API → Substrate Node → ink! Contract

Governance DApp Architecture

┌─────────────────────────────────────┐
│         User Interface              │
│    (React Components + Tailwind)   │
├─────────────────────────────────────┤
│         Context Providers           │
│    (Wallet + Governance Context)   │
├─────────────────────────────────────┤
│         Contract Client             │
│    (Polkadot API + Typink)         │
├─────────────────────────────────────┤
│         Smart Contract              │
│    (ink! Governance Contract)      │
└─────────────────────────────────────┘

🎯 Use Cases

Token Contracts

DeFi Applications: Lending, borrowing, staking
NFT Marketplaces: Payment tokens
DAO Governance: Voting tokens
Cross-chain Bridges: Bridge tokens

Governance Contracts

DAO Management: Decentralized decision making
Treasury Management: Fund allocation
Protocol Upgrades: Governance-controlled changes
Community Voting: Proposal and voting systems

Utility Contracts

Todo Lists: Task management dApps
Piggy Banks: Savings and goal tracking
Escrow Services: Secure fund holding
Multi-signature Wallets: Shared control

🔒 Security Considerations

Best Practices Implemented

Safe Arithmetic: Overflow/underflow protection
Access Control: Owner-only functions
Input Validation: Parameter checking
Event Logging: Comprehensive event emission
Error Handling: Detailed error messages
Testing: Unit and integration tests

Security Features

Pausable contracts for emergency stops
Blacklist functionality for malicious addresses
Time-locked operations for critical functions
Multi-signature requirements for sensitive operations
Quorum requirements for governance decisions

📈 Performance Optimizations

Storage Patterns

Mapping vs Vec: Efficient storage selection
Packed Structs: Optimized data layout
Lazy Loading: On-demand data access
Batch Operations: Reduced transaction costs

Gas Optimization

Minimal Storage: Only store necessary data
Efficient Algorithms: Optimized computation
Event Optimization: Selective event emission
Contract Size: Minimized WASM size

Frontend Optimizations

Code Splitting: Lazy loading of components
Image Optimization: Next.js image optimization
Bundle Analysis: Webpack bundle analyzer
Caching: Strategic caching strategies

🤝 Contributing

Development Setup

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

Code Standards

Follow Rust conventions
Add comprehensive tests
Document public functions
Use meaningful variable names
Implement proper error handling
Follow TypeScript best practices
Use consistent formatting

Pull Request Process

Ensure all tests pass
Update documentation
Add changelog entries
Request code review
Address feedback
Merge after approval

📄 License

This project is provided as-is for educational purposes. Individual contracts may have different licenses - check each contract's directory for specific licensing information.

🆘 Support

For issues and questions:

Create an issue in the repository
Join the ink! Discord community
Check the troubleshooting section above
Review the documentation links

🎉 Recent Updates

Governance DApp v1.0.0

✅ Real contract integration with Polkadot API
✅ Production-ready build system
✅ Comprehensive error handling
✅ Mobile-responsive design
✅ Type-safe contract interactions
✅ Wallet connection support
✅ Real-time blockchain data

Smart Contracts v6.0.0

✅ ink! v6.0.0-alpha.4 support
✅ Enhanced governance features
✅ Improved error handling
✅ Optimized storage patterns
✅ Comprehensive test coverage

🦀 Built with Rust + ink! v6.0.0-alpha.4

This collection demonstrates the power and flexibility of ink! smart contracts in the Polkadot ecosystem, from simple utility contracts to complex governance systems with production-ready frontends.

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
Token		Token
frontend		frontend
governance		governance
ink-bootcamp-erc20-boilerplate		ink-bootcamp-erc20-boilerplate
todo		todo
todo_map		todo_map
v6psp20		v6psp20
v6psp20piggybank		v6psp20piggybank
README.md		README.md
v6psp20piggybank.tar.gz		v6psp20piggybank.tar.gz

ogazboiz/ink

Folders and files

Latest commit

History

Repository files navigation

🦀 Ink! Smart Contracts Collection

🧭 Quick Navigation

Smart Contracts

Frontend Applications

📁 Project Structure

📦 Smart Contracts (Rust + ink! v6)

🎨 Frontend Applications

📄 Documentation

🚀 Quick Start

Prerequisites

Local Development Setup

📦 Smart Contracts

🏛️ Governance Contract

Core Features

Key Functions

Data Structures

🪙 PSP22 Token Contracts

ink-bootcamp-erc20-boilerplate

Token Contract

v6psp20

🐷 Piggy Bank Contract

✅ Todo List Contracts

Simple Todo

Todo with Mapping

🎨 Frontend Applications

🏛️ DAO Governance DApp

Features

Key Components

Technology Stack

ERC20 Frontend

Web3Bridge Curriculum

🛠️ Development Workflow

Building Contracts

Testing

Frontend Development

Deployment Options

1. Local Development

2. Contracts UI

3. Polkadot.js Apps

4. Test Networks

📚 Contract APIs

Common Functions

🔧 Configuration

Cargo.toml Dependencies

Frontend Dependencies

🧪 Testing

Unit Tests

Integration Tests

Frontend Tests

🚨 Troubleshooting

Common Issues

"CodeRejected" Error

"Cannot connect to node"

"Insufficient funds"

Frontend Build Issues

📖 Learning Resources

Documentation

Tools

Community

🏗️ Architecture Overview

Smart Contract Stack

Contract Interaction Flow

Governance DApp Architecture

🎯 Use Cases

Token Contracts

Governance Contracts

Utility Contracts

🔒 Security Considerations

Best Practices Implemented

Security Features

📈 Performance Optimizations

Storage Patterns

Gas Optimization

Frontend Optimizations

🤝 Contributing

Packages