Overview
Welcome to the WireFluid Developer Guide! Whether you’re new to blockchain development or an experienced developer, this guide will help you build and deploy applications on WireFluid efficiently.
Getting Started Checklist
Complete these steps to start building on WireFluid:
Total Setup Time: 10-15 minutes
Guide Structure
💡 Quick Start: If you’re using browser-based tools (Remix), you only need MetaMask, network configuration, and testnet tokens!
1. Prerequisites
Essential setup before you start coding.
- Required for command-line development
- Install JavaScript runtime and package manager
- Time: 5-10 minutes
- Manage your wallet and sign transactions
- Essential for all WireFluid interactions
- Time: 3-5 minutes
- Add WireFluid to your wallet
- Connect to testnet or mainnet
- Time: 2 minutes
- Request free test WIRE for development
- Required for deploying and testing
- Time: 1 minute
2. Network Configuration
Everything you need to connect to WireFluid.
- RPC endpoints and connection URLs
- Chain ID and network parameters
- Add network to MetaMask wallet
- Automatic and manual configuration
- Time: 2 minutes
- Request testnet tokens
- Understand faucet limits
- Time: 1 minute
3. Development Paths
Choose the development environment that fits your needs.
- Best for: Beginners, prototyping, learning
- Setup: Instant (no installation)
- Features: Visual interface, built-in compiler, debugger
- Start here if: You’re new to blockchain or want quick results
- Best for: Professional development, production apps
- Setup: 5 minutes (requires Node.js)
- Features: Automated testing, deployment scripts, team collaboration
- Start here if: You’re building serious applications
Network Overview
Testnet vs Mainnet
| Feature | WireFluid Testnet | WireFluid Mainnet |
|---|---|---|
| Purpose | Testing & development | Production applications |
| Tokens | Free test WIRE | Real WIRE (has value) |
| Explorer | wirefluidscan.com | Coming soon |
| RPC | https://evm.wirefluid.com | TBA |
| Chain ID | 92533 | TBA |
⚠️ Always test on testnet first! Never deploy directly to mainnet without thorough testing.
Network Characteristics
Fast & Efficient:
- Block Time: ~5 seconds
- Finality: Instant (single-block)
- TPS: ~1,000 transactions per second
EVM Compatible:
- Languages: Solidity, Vyper
- Tools: Remix, Hardhat, Foundry, Truffle
- Libraries: ethers.js, web3.js, web3.py
Low Cost:
- Gas Fees: 100-1000x cheaper than Ethereum
- Predictable: Stable pricing, no gas wars
- Fast: Transactions confirm in seconds
Essential Tools
Development Tools
| Tool | Purpose | When to Use |
|---|---|---|
| Remix IDE | Browser-based development | Learning, prototyping |
| Hardhat | Professional framework | Production apps |
| VS Code | Code editor | All development |
Blockchain Tools
| Tool | Purpose | Link |
|---|---|---|
| MetaMask | Wallet & transaction signing | metamask.io |
| WireScan | Block explorer | wirefluidscan.com |
| Faucet | Get testnet tokens | faucet.wirefluid.com |
| RPC Endpoints | Network connection | Network Details |
Libraries
| Library | Purpose | Documentation |
|---|---|---|
| ethers.js | Ethereum library (recommended) | docs.ethers.org |
| web3.js | Alternative Ethereum library | web3js.org |
| OpenZeppelin | Secure contract templates | docs.openzeppelin.com |
Best Practices
Security
Always:
- Test on testnet first
- Use audited libraries (OpenZeppelin)
- Verify contracts on WireScan
Never:
- Deploy untested code to mainnet
- Expose private keys
- Skip security audits for production
- Ignore compiler warnings
Development
Do:
- Write comprehensive tests
- Document your code
- Use version control (Git)
- Follow naming conventions
- Optimize gas usage
Don’t:
- Commit private keys
- Skip code reviews
- Ignore errors
- Deploy without testing
- Use deprecated patterns
Cost Optimization
Optimize:
- Batch transactions
- Use events for logs
- Pack storage variables
- Minimize storage writes
- Use view/pure functions
Avoid:
- Unnecessary storage
- Redundant computations
- Unbounded loops
- Large arrays on-chain
- Inefficient algorithms
Troubleshooting
Common Issues
“Insufficient funds for gas”
- Get more testnet WIRE from faucet
- Check you’re on the correct network
“Transaction failed”
- Check gas limit is sufficient
- Verify contract requirements are met
- Review error message in WireScan
“Cannot connect to network”
- Verify Network Details
- Try resetting MetaMask connection
“Nonce too high/low”
- Reset account in MetaMask (Settings → Advanced → Reset Account)
- Don’t manually set nonce unless necessary
Next Steps
By Experience Level
Beginner (New to Blockchain):
Intermediate (Some Experience):
By Project Type
Building a Token:
Building an NFT:
Resources
Documentation
Tutorials
Tools & References
Ready to build? Start with Prerequisites → or jump straight to Your First Contract →!