← Back to Resources

Complete Wallet & Blockchain Guide

Purpose: Comprehensive guide for wallet connection, blockchain deployment, and cryptocurrency operations
Audience: All platform users - from beginners to advanced
Last Updated: November 17, 2025


Table of Contents

Part 1: Getting Started

  1. Quick Start: First-Time Users
  2. Understanding Digital Wallets
  3. Why Blockchain?

Part 2: Wallet Setup & Connection

  1. Installing Your First Wallet
  2. Connecting to the Platform
  3. Network Configuration (SEI)
  4. Supported Wallet Types

Part 3: Blockchain Deployment

  1. Deploying Projects to Blockchain
  2. On-Chain vs Off-Chain
  3. Gas Fees & Costs

Part 4: Daily Operations

  1. Managing Transactions
  2. Security Best Practices
  3. Multi-Wallet Management

Part 5: Troubleshooting & Support

  1. Common Issues & Solutions
  2. Getting Help
  3. FAQs

Part 1: Getting Started

Quick Start: First-Time Users

Complete Setup in 5 Minutes:

Step 1: Install MetaMask (1 minute)

  1. Visit metamask.io
  2. Click "Download" and install for your browser
  3. Create a new wallet with a strong password
  4. Write down your seed phrase and store it safely (never share this!)

Step 2: Add SEI Network (1 minute)

  1. Open MetaMask extension
  2. Click the network dropdown at the top
  3. Select "Add Network" → "Add a network manually"
  4. Enter these details: Network name: SEI Mainnet RPC URL: https://evm-rpc.sei-apis.com Chain ID: 1329 Currency symbol: SEI Block explorer: https://seitrace.com
  5. Click "Save"

Step 3: Get SEI Tokens (2 minutes)

  1. Purchase SEI on an exchange (Binance, Coinbase, etc.)
  2. Send ~0.5 SEI to your MetaMask address
  3. This covers gas fees for ~10-20 project deployments

Step 4: Connect to Platform (1 minute)

  1. Visit contracting.app
  2. Log in to your account
  3. Click "Connect Wallet" button
  4. Select "MetaMask"
  5. Approve the connection
  6. ✅ You're ready to use blockchain features!

Understanding Digital Wallets

What is a Cryptocurrency Wallet?

A cryptocurrency wallet is a digital tool that manages your cryptographic keys - think of it as a secure digital keychain that proves you own your cryptocurrency.

Key Components:

  1. Private Key: Your secret key (like a password) that proves ownership
  2. Public Key: Derived from your private key, used to generate addresses
  3. Wallet Address: Public identifier where others can send you cryptocurrency (like an email address)
  4. Seed Phrase: 12-24 word backup phrase to recover your wallet if lost

Important: Your wallet doesn't actually "store" cryptocurrency - it stores the keys that give you access to your cryptocurrency on the blockchain.

How Wallets Work

Seed Phrase (12-24 words)
    ↓
Private Key (your secret)
    ↓
Public Key (derived from private)
    ↓
Wallet Address (public identifier: 0x742d35Cc...)

Wallet vs Account vs Address


Why Blockchain?

Benefits of Using Blockchain Features

1. Immutable Record-Keeping - Project details, milestones, and payments are permanently recorded - Creates an audit trail that cannot be manipulated - Protects against disputes over project history

2. Automated Payment Processing - Smart contracts automatically release payments when conditions are met - Eliminates delays from manual processing - Ensures fair and timely compensation

3. Transparent Audit Trail - All stakeholders can verify project status in real-time - Builds trust between contractors, developers, and owners - Simplifies compliance and reporting

4. Enhanced Security - RSA-4096 + AES-256-GCM encryption for sensitive data - Multi-signature requirements prevent unauthorized actions - Protection against fraud and tampering

5. Dispute Resolution - Built-in dispute mechanisms with transparent resolution - On-chain evidence is tamper-proof - Reduces legal costs and time

When to Use Blockchain

Use blockchain deployment for: - High-value projects requiring extra security - Multi-party projects needing automated payments - Projects requiring immutable documentation - Situations where trust needs to be verified

Standard database is fine for: - Simple projects with one payer - Internal projects not requiring blockchain proof - Projects still in planning stages - Situations where you might need to edit extensively


Part 2: Wallet Setup & Connection

Installing Your First Wallet

Why MetaMask? - Most popular and widely supported - Easy to use with simple interface - Available on all major browsers - Mobile app available - Free to use

Installation Steps:

Desktop (Browser Extension): 1. Go to metamask.io in your browser 2. Click "Download" 3. Select your browser (Chrome, Firefox, Edge, or Brave) 4. Click "Install MetaMask for [Browser]" 5. Confirm installation in browser extension store

Create New Wallet: 1. Click the MetaMask icon in your browser 2. Click "Create a Wallet" 3. Accept or decline analytics sharing 4. Create a strong password (at least 8 characters) 5. Watch the seed phrase security video (important!) 6. Write down your 12-word seed phrase: - Use pen and paper (never digital) - Store in a secure location - Never share with anyone - Consider making multiple copies in secure locations 7. Confirm seed phrase by selecting words in correct order 8. ✅ Wallet created successfully!

Mobile App: 1. Download "MetaMask" from App Store (iOS) or Google Play (Android) 2. Open app and follow same creation process 3. Enable biometric authentication (fingerprint/face ID) 4. Consider adding additional security features

Method 2: Hardware Wallets (For Large Amounts)

Ledger Nano S Plus / Nano X:

When to Use: - Managing significant cryptocurrency amounts ($5,000+) - Maximum security requirements - Long-term storage (not frequent transactions) - Enterprise/business accounts

Setup Process: 1. Purchase from official Ledger store (ledger.com) - never buy used! 2. Unbox and connect device to computer via USB 3. Follow on-device instructions to initialize 4. Create a PIN (4-8 digits) 5. Write down 24-word recovery phrase - Use the included recovery cards - Store in fireproof/waterproof location - Never enter into any computer 6. Verify recovery phrase on device 7. Install Ledger Live software on computer 8. Install Ethereum app on device via Ledger Live 9. Enable "Blind signing" in Ethereum app settings (required for our platform)

Connecting Ledger to Platform: 1. Connect Ledger to computer 2. Enter PIN on device 3. Open Ethereum app on Ledger 4. Visit contracting.app 5. Click "Connect Wallet" 6. Select "Ledger Hardware Wallet" 7. Choose "Connect via WebUSB" 8. Select your device from browser popup 9. Confirm connection on Ledger device

Security Advantages: - Private keys never leave the device - Immune to computer malware - Physical confirmation required for all transactions - Can be used on compromised computers safely

Method 3: Compass Wallet (SEI Native)

Why Compass? - Native SEI blockchain support - Lower gas fees on SEI network - Optimized for our platform - Cosmos ecosystem integration

Installation: 1. Visit compasswallet.io 2. Download browser extension or mobile app 3. Install and open Compass 4. Create new wallet 5. Save 24-word seed phrase securely 6. Set password 7. SEI network is pre-configured (no manual setup needed!)

Connecting to Platform: 1. Visit contracting.app 2. Click "Connect Wallet" 3. Select "Compass" 4. Approve connection in Compass popup 5. Select account to use


Connecting to the Platform

Initial Connection

Step 1: Navigate to Wallet Settings 1. Log in to your account at contracting.app 2. Click your profile picture (top right) 3. Select "Settings""Wallet" 4. Or click "Connect Wallet" button on dashboard

Step 2: Choose Wallet Type - MetaMask (browser extension) - Hardware Wallet (Ledger/Trezor) - Compass (SEI native) - Mobile Wallet (via QR code)

Step 3: Approve Connection 1. Your wallet will open in a popup 2. Review the connection request 3. Click "Connect" or "Approve" 4. Select which account to use (if you have multiple)

Step 4: Verify Connection - Green checkmark appears next to wallet address - Your Ethereum address displays in navigation bar - Address is saved to your profile - Ready to use blockchain features!

Connection Status Indicators

🟢 Connected: MetaMask
📍 Address:   0x742d35Cc...B4b79a14
🌐 Network:   SEI Mainnet
💰 Balance:   1,247.50 SEI
⚡ Status:    Ready for transactions

Disconnecting Your Wallet

To temporarily disconnect: 1. Go to Settings → Wallet 2. Click "Disconnect Wallet" 3. Confirm disconnection 4. Wallet address removed from profile

To permanently remove: 1. Disconnect wallet from platform (above) 2. Open your wallet extension 3. Go to connected sites/permissions 4. Remove contracting.app from list


Network Configuration (SEI)

Automatic Network Addition

When you first connect your wallet, the platform automatically: - Detects you're not on SEI network - Prompts to add SEI Mainnet - Configures all network settings - Switches to SEI network

Just click "Add Network" when prompted!

Manual Network Configuration

If automatic addition doesn't work:

For MetaMask: 1. Open MetaMask 2. Click network dropdown (top) 3. Click "Add network" 4. Click "Add a network manually" 5. Enter details:

Network name:          SEI Mainnet
New RPC URL:          https://evm-rpc.sei-apis.com
Chain ID:             1329
Currency symbol:      SEI
Block explorer URL:   https://seitrace.com
  1. Click "Save"
  2. Switch to SEI Mainnet

For Compass: - SEI network is pre-configured - No manual setup needed!

For Ledger: - Use Ethereum app on device - Network configured through MetaMask connection - Follow MetaMask setup above

Network Switching

Automatic Switching: - Platform detects when you're on wrong network - Prompts "Switch to SEI Mainnet?" - Click "Switch network" to approve - Wallet changes network automatically

Manual Switching: 1. Click network dropdown in wallet 2. Select "SEI Mainnet" 3. Refresh platform page if needed

Verifying Network Connection

Check you're on the correct network: - Wallet shows "SEI Mainnet" at top - Platform shows green "Connected" status - Currency symbol is "SEI" (not ETH) - Chain ID is 1329


Supported Wallet Types

Comparison Chart

Wallet Type Security Ease of Use Cost Best For
MetaMask ⭐⭐⭐ ⭐⭐⭐⭐⭐ Free Beginners, frequent users
Compass ⭐⭐⭐ ⭐⭐⭐⭐ Free SEI network users
Ledger ⭐⭐⭐⭐⭐ ⭐⭐⭐ $79-149 Large amounts, enterprise
Trezor ⭐⭐⭐⭐⭐ ⭐⭐⭐ $69-299 Large amounts, privacy
Trust Wallet ⭐⭐⭐ ⭐⭐⭐⭐ Free Mobile users

Detailed Wallet Features

Browser Extension Wallets: - MetaMask (most popular) - Compass (SEI optimized) - Pros: Convenient, free, easy to use - Cons: Less secure than hardware (but fine for most users)

Hardware Wallets: - Ledger (Nano S Plus, Nano X) - Trezor (Model One, Model T) - Pros: Maximum security, immune to malware - Cons: Cost money, less convenient

Mobile Wallets: - MetaMask Mobile - Trust Wallet - Compass Mobile - Pros: On-the-go access, QR code support - Cons: Less secure than hardware

Multi-Signature Wallets (Enterprise): - Gnosis Safe - Pros: Requires multiple approvals, perfect for teams - Cons: More complex setup


Part 3: Blockchain Deployment

Deploying Projects to Blockchain

What is Blockchain Deployment?

Deploying a project to the blockchain means creating a permanent, immutable record of your project on the SEI blockchain network. This enables: - Smart contract automation - Tamper-proof record keeping - Multi-party payment workflows - Transparent dispute resolution

Prerequisites

Before deploying, ensure you have:

Web3 wallet connected (MetaMask, Compass, etc.)
At least 0.1 SEI in your wallet for gas fees
Project details complete: name, amount, participants
SEI Mainnet selected in your wallet

Step-by-Step Deployment Process

Step 1: Navigate to Your Project 1. Log in to contracting.app 2. Go to "Projects" in main navigation 3. Find the project you want to deploy 4. Verify it shows "Off-Chain" status

Step 2: Initiate Deployment 1. Click the three-dot menu (⋮) next to project 2. Select "Deploy to Blockchain" 3. Deployment modal opens with project details

Step 3: Review Project Information

The modal displays: - ✓ Project name - ✓ Total contract amount - ✓ Network: SEI Mainnet - ✓ Estimated gas fee: ~0.05-0.1 SEI - ⚠️ Warning: Deployment is permanent and irreversible

Step 4: Confirm Deployment 1. Review all details carefully 2. Click "Deploy to Blockchain" button 3. Platform prepares smart contract transaction

Step 5: Approve in MetaMask 1. MetaMask popup appears automatically 2. Review transaction details: - Contract interaction: ProjectFactoryV2 - Gas fee estimate - Total cost 3. Click "Confirm" to proceed 4. Or click "Reject" to cancel

Step 6: Wait for Confirmation - Transaction sent to SEI blockchain - Typically takes 5-30 seconds - Loading indicator shows progress - Don't close browser tab during deployment

Step 7: Deployment Complete! 🎉

Success screen shows: - ✅ "Project deployed successfully" - 📝 Contract address: 0x... - 🔗 Transaction hash (link to blockchain explorer) - 📊 Project now shows "On-Chain" status

What Gets Deployed?

On-Chain Data (stored on blockchain): - Project ID and name - Total contract value - Creator address - Participant addresses and roles - Milestone information - Payment schedules - Approval thresholds - Manager contract addresses

Off-Chain Data (database only): - Detailed descriptions - Document attachments - Chat messages - Activity logs - User interface preferences

Encrypted Data (on-chain but encrypted): - Financial details (RSA-4096 + AES-256-GCM) - Sensitive participant information - Payment routing details - Only authorized parties can decrypt


On-Chain vs Off-Chain

Off-Chain Projects

Characteristics: - Stored only in application database - Can be edited, updated, or deleted - Standard payment processing - No blockchain features - No gas fees required - Faster to create and modify

Status Badge: 🗄️ Off-Chain

Best For: - Projects in planning stages - Internal company projects - Low-value or simple contracts - Situations requiring frequent edits

On-Chain Projects

Characteristics: - Core data stored on blockchain - Immutable (cannot be edited, only revised) - Smart contract payment automation - Blockchain features enabled: - Automated milestone payments - Multi-signature approvals - Dispute resolution - Transparent audit trail - Requires gas fees for transactions

Status Badge: ✅ On-Chain

Best For: - Multi-party commercial projects - High-value contracts - Projects requiring immutable proof - Automated payment workflows - Situations requiring maximum trust

Can I Switch Back?

No. Once deployed to blockchain, a project cannot be reverted to off-chain status. The blockchain data is permanent.

However, you can: - Continue managing the project through the platform interface - Submit revisions (new versions) with updated information - Add milestones and participants after deployment - All changes create new on-chain records (full history preserved)

Side-by-Side Comparison

Feature Off-Chain On-Chain
Storage Database only Blockchain + Database
Immutability Can be edited/deleted Permanent record
Gas Fees None Yes (~0.05 SEI per action)
Setup Time Instant 5-30 seconds
Smart Contracts No Yes
Automated Payments Manual Automatic
Multi-Sig Approvals No Yes
Dispute Resolution Standard Blockchain-based
Audit Trail Database logs Immutable blockchain
Trust Level Application-based Cryptographically verified
Suitable For Simple projects Complex multi-party

Gas Fees & Costs

What Are Gas Fees?

Gas fees are small payments to the blockchain network for processing transactions. Think of them like transaction fees at a bank, but they go to: - Network validators who process your transaction - Secure the blockchain network - Prevent spam transactions

Paid in: SEI tokens on the SEI network

Typical Cost Breakdown

Transaction Type Estimated Gas Fee Frequency
Deploy Project ~0.05 - 0.1 SEI One-time per project
Approve Milestone ~0.01 - 0.03 SEI Per milestone
Release Payment ~0.02 - 0.05 SEI Per payment
Add Participant ~0.01 - 0.02 SEI Per participant
Raise Dispute ~0.01 - 0.03 SEI Per dispute
Submit Revision ~0.02 - 0.04 SEI Per revision

Example Project Cost:

Project Setup:
- Initial deployment: 0.08 SEI
- Add 3 participants: 0.05 SEI
- Total setup: 0.13 SEI (~$1-2 USD)

During Project:
- 5 milestones × 0.02 SEI: 0.10 SEI
- 5 payments × 0.03 SEI: 0.15 SEI
- Total operations: 0.25 SEI (~$2-3 USD)

Grand Total: ~0.38 SEI (~$3-5 USD) for entire project

Why SEI Network?

We chose SEI because it offers:

Low Fees: 95% cheaper than Ethereum
Fast: 5-30 second transaction confirmation
DeFi Optimized: Built for financial applications
Reliable: High uptime and security
EVM Compatible: Works with existing tools

Cost Comparison: | Network | Deploy Project Cost | Payment Release Cost | |---------|---------------------|----------------------| | Ethereum | ~$50-200 | ~$10-50 | | Polygon | ~$0.50-2 | ~$0.10-0.50 | | SEI | ~$0.50-1 | ~$0.10-0.20 |

How to Get SEI Tokens

Method 1: Centralized Exchanges (Easiest) 1. Create account on exchange (Binance, Coinbase, KuCoin, etc.) 2. Complete KYC verification 3. Buy SEI with USD/EUR/etc. 4. Withdraw to your MetaMask address

Method 2: Decentralized Exchanges (DEX) 1. Visit a SEI-based DEX (Dragonswap, etc.) 2. Connect your wallet 3. Swap another cryptocurrency for SEI 4. SEI appears in your wallet

Method 3: Bridge from Other Networks 1. Use a bridge protocol (Stargate, Wormhole, etc.) 2. Bridge tokens from Ethereum/Polygon to SEI 3. Swap for SEI on a DEX

Method 4: P2P / OTC 1. Find SEI seller on P2P platforms 2. Arrange direct purchase 3. Transfer to your wallet

Gas Fee Best Practices

To minimize gas costs: - Batch multiple actions when possible - Deploy during off-peak hours (lower congestion) - Keep 0.5-1 SEI in wallet for multiple transactions - Don't over-estimate gas limits (wallet calculates automatically)

Gas Fee FAQs:

Q: Who pays the gas fees?
A: The person signing the transaction pays. Typically: - Project creator pays deployment fee - Milestone approvers pay approval fees - Payment authorizers pay release fees

Q: Are there any recurring costs?
A: No monthly/annual fees. You only pay gas when performing actions.

Q: Can I get refunds on failed transactions?
A: No, gas fees are paid to network validators regardless of success/failure.

Q: Why do fees vary?
A: Fees depend on network congestion and transaction complexity.


Part 4: Daily Operations

Managing Transactions

Transaction Workflow

1. Action Initiated - You click a button in the platform (e.g., "Approve Milestone") - Platform prepares smart contract transaction - Transaction details sent to your wallet

2. Wallet Popup - Your wallet opens automatically - Shows transaction details: - Contract being called - Function being executed - Gas fee estimate - Total cost

3. Review & Approve - Carefully review all details - Verify recipient addresses - Check gas fee is reasonable - Click "Confirm" to proceed

4. Transaction Processing - Sent to blockchain network - Waiting for confirmation (5-30 seconds) - Status shown in platform

5. Confirmation - Success or failure notification - Transaction hash provided - Blockchain explorer link - Result reflected in platform

Transaction Confirmation Modal

Transaction Preview:
┌─────────────────────────────────────┐
│ Action:      Approve Milestone #3   │
│ Project:     Office Building        │
│ Milestone:   Foundation Complete    │
│ Amount:      $50,000.00            │
│ Gas Fee:     ~0.02 SEI             │
│                                     │
│ [Cancel]         [Confirm & Sign]  │
└─────────────────────────────────────┘

Tracking Transaction Status

In-Platform: - Real-time status updates - Transaction history log - Success/failure notifications - Automatic page updates

Blockchain Explorer: 1. Copy transaction hash from confirmation 2. Visit seitrace.com 3. Paste hash in search bar 4. View detailed transaction info: - Confirmation status - Block number - Gas used - Contract interactions

Transaction Types

Project Management: - Deploy project - Add participants - Submit revisions - Update project parameters

Milestone Operations: - Create milestones - Approve milestone completion - Reject milestones - Modify milestone details

Payment Processing: - Release payments - Authorize transfers - Set up recurring payments - Cancel pending payments

Dispute Resolution: - Raise disputes - Submit evidence - Vote on resolutions - Execute dispute outcomes


Security Best Practices

Wallet Security

Critical Rules:

🚨 NEVER share your seed phrase with anyone, ever - Not support staff - Not developers - Not "wallet verification" services - Not anyone claiming to be from the platform

🚨 NEVER enter your seed phrase on any website or app - Only enter when recovering in official wallet software - Be extremely cautious of phishing attempts

🚨 NEVER store seed phrase digitally - No photos on your phone - No text files on computer - No cloud storage - Use physical paper in secure location

Password Security

Use a strong password for your wallet: - At least 12 characters - Mix of uppercase, lowercase, numbers, symbols - Unique (not reused from other accounts) - Consider using a password manager

Enable additional security: - Browser extension password lock - Biometric authentication (mobile) - Hardware security keys (advanced)

Transaction Security

Before Signing Any Transaction:

✅ Verify the contract address is correct
✅ Check the function being called makes sense
✅ Confirm recipient addresses are accurate
✅ Verify amounts are as expected
✅ Review gas fee is reasonable (not 10x normal)
✅ Make sure you're on the correct network (SEI Mainnet)

Red Flags - DON'T SIGN if: - You don't recognize the action - Contract address looks suspicious - Gas fee is extremely high - You're being rushed or pressured - Request comes from unexpected popup

Phishing Protection

How to Identify Phishing Attempts:

🚩 Suspicious emails claiming: - "Your wallet needs verification" - "Urgent: Update your security settings" - Links to websites similar to but not exactly contracting.app

🚩 Fake websites: - contracting-app.com (wrong domain) - contracting.app.verify.com (subdomain scam) - Always verify URL is exactly: contracting.app

🚩 Social media scams: - Direct messages offering "support" - Too-good-to-be-true promotions - Requests for seed phrases or private keys

Protection Strategies: - Bookmark the official site: contracting.app - Always access site from your bookmark - Enable anti-phishing features in your wallet - Be skeptical of unsolicited contact - When in doubt, contact official support directly

Computer Security

✅ Keep software updated: - Operating system - Browser - Wallet extension - Antivirus software

✅ Use secure browsing practices: - Clear browser cache regularly - Use privacy mode for sensitive operations - Disable unnecessary browser extensions - Consider dedicated browser for crypto

✅ Protect your device: - Use full-disk encryption - Lock screen when away - Be cautious on public WiFi - Use VPN for additional privacy

Hardware Wallet Best Practices

For Ledger/Trezor Users:

✅ Purchase only from official sources
✅ Verify device hasn't been tampered with
✅ Never use a device that came with seed phrase pre-filled
✅ Keep firmware updated
✅ Always verify transaction details on device screen
✅ Store device and seed phrase separately

Enterprise Security (Teams/Organizations)

Multi-Signature Wallets: - Require 2-3+ approvals for transactions - Distribute authority across team members - Set spending limits - Use role-based access control

Access Management: - Limit who can initiate transactions - Separate approval and execution roles - Regular security audits - Documented procedures for key personnel changes

Backup & Recovery: - Document wallet addresses used - Store recovery information in company safe - Create succession plan for key holders - Test recovery procedures periodically


Multi-Wallet Management

Why Use Multiple Wallets?

Separation of Concerns: - Personal wallet for small transactions - Business wallet for company projects - Savings wallet (hardware) for long-term storage - Hot wallet (MetaMask) for daily operations

Risk Management: - Limit exposure if one wallet is compromised - Different security levels for different purposes - Easier accounting and reconciliation

Adding Multiple Wallets to Platform

Step 1: Add Secondary Wallet 1. Go to Settings → Wallets 2. Click "Add Another Wallet" 3. Select wallet type 4. Connect and approve 5. Label wallet (e.g., "Business Account", "Hardware Wallet")

Step 2: Set Wallet Roles

Assign purposes: - Primary Wallet: Default for transactions - Backup Wallet: Fallback if primary unavailable - Read-Only Wallet: View balance only, cannot transact

Step 3: Configure Preferences

Wallet Configuration:
┌─────────────────────────────────────┐
│ Primary Wallet:     [MetaMask    ▼] │
│ Backup Wallet:      [Ledger     ▼] │
│ Transaction Limit:  [$10,000      ] │
│ Auto-Switch:        [✓] Enabled     │
│ Require Confirm:    [✓] Yes         │
└─────────────────────────────────────┘

Switching Between Wallets

Quick Switch: 1. Click wallet address in top navigation 2. Dropdown shows all connected wallets 3. Select wallet to use 4. Platform switches context automatically 5. All transactions use newly selected wallet

Automatic Switching: - Platform can auto-select wallet based on transaction type - Example: Use hardware wallet for payments > $10,000 - Configure in Settings → Wallets → Auto-Switch Rules

Wallet Management Dashboard

View All Wallets:

Connected Wallets:

MetaMask (Primary)
├─ Address: 0x742d35...B4b79a14
├─ Balance: 125.50 SEI
├─ Network: SEI Mainnet
└─ Status: 🟢 Active

Ledger (Backup)
├─ Address: 0x9A123f...C8e90d2
├─ Balance: 1,450.00 SEI
├─ Network: SEI Mainnet
└─ Status: 🟡 Inactive (Connect device)

Compass (Read-Only)
├─ Address: 0x3B789e...F1a234c
├─ Balance: 50.25 SEI
├─ Network: SEI Mainnet
└─ Status: 🟢 Connected (View-only)

Part 5: Troubleshooting & Support

Common Issues & Solutions

Wallet Connection Issues

Problem: "Wallet not detected"

Solutions: 1. Refresh the page 2. Check wallet extension is installed and enabled 3. Disable ad blockers temporarily 4. Try incognito/private browsing mode 5. Update wallet extension to latest version 6. Try a different browser

Problem: "Connection keeps failing"

Solutions: 1. Clear browser cache and cookies 2. Disable conflicting extensions 3. Check wallet isn't connected to another site 4. Restart browser 5. Reinstall wallet extension (as last resort)

Problem: "Wrong network" errors

Solutions: 1. Click "Switch Network" when prompted 2. Manually switch to SEI Mainnet in wallet 3. Verify network settings match requirements: - Chain ID: 1329 - RPC: https://evm-rpc.sei-apis.com 4. Remove and re-add network if corrupted

Transaction Problems

Problem: "Insufficient funds for gas"

Solutions: 1. Check SEI balance in wallet 2. Need at least 0.1 SEI for gas 3. Purchase more SEI from exchange 4. Verify you're on correct network (not testnet)

Problem: "Transaction failed" after signing

Possible Causes & Fixes: 1. Gas price too low: - Increase gas price in wallet settings - Use "Fast" or "Aggressive" gas option 2. Network congestion: - Wait 5-10 minutes and retry - Try during off-peak hours 3. Contract error: - Check project data is complete - Verify all required fields filled - Contact support with transaction hash

Problem: "Transaction stuck as pending"

Solutions: 1. Wait 2-3 minutes (normal during congestion) 2. Check transaction status on blockchain explorer 3. If stuck > 10 minutes: - Cancel transaction in wallet (if possible) - Try with higher gas price 4. If you accidentally sent with low gas, can "speed up" in MetaMask

Problem: "Payment not appearing"

Solutions: 1. Wait 2-3 minutes for blockchain confirmation 2. Check transaction on seitrace.com with transaction hash 3. Verify correct recipient address was used 4. Confirm wallet is on correct network 5. Contact support if payment confirmed but not visible

Blockchain Deployment Issues

Problem: "Project is already deployed on blockchain"

Solution: - This means deployment was successful! - Check project details page for: - Contract address - Blockchain project ID - Transaction history - Status badge should show "On-Chain"

Problem: "Please install MetaMask or another Web3 wallet"

Solutions: 1. Install MetaMask from metamask.io 2. Or install Compass from compasswallet.io 3. Create wallet account 4. Refresh page and try again

Problem: "You need to connect a Web3 wallet first"

Solutions: 1. Go to Account Settings → Wallet 2. Click "Connect Wallet" 3. Approve connection in wallet popup 4. Return to project and retry deployment

Problem: Deployment taking too long

Normal timing: - 5-30 seconds: Normal - 1-2 minutes: Network congestion - 3+ minutes: Likely issue

If stuck: 1. Check transaction status in wallet 2. Copy transaction hash 3. Check on seitrace.com 4. Don't refresh page until confirmed or failed 5. Contact support if genuinely stuck

Mobile Wallet Issues

Problem: "QR code won't scan"

Solutions: 1. Ensure good lighting 2. Hold phone steady, proper distance 3. Clean camera lens 4. Try manual connection code entry 5. Use different mobile wallet app

Problem: "Mobile wallet disconnects"

Solutions: 1. Keep mobile app open during transactions 2. Disable power saving mode 3. Ensure stable internet connection 4. Re-scan QR code to reconnect 5. Try using browser extension instead

Hardware Wallet Issues

Problem: "Ledger not detected"

Solutions: 1. Ensure device is unlocked (PIN entered) 2. Open Ethereum app on Ledger 3. Use compatible browser (Chrome, Brave) 4. Try different USB cable 5. Install/update Ledger Live 6. Enable "Blind signing" in Ethereum app settings

Problem: "Transaction rejected on device"

Solutions: 1. Verify transaction details on device screen 2. Ensure you meant to reject 3. If rejected accidentally, retry transaction 4. Check device firmware is updated


Getting Help

Self-Service Resources

1. Platform Documentation - User guides: contracting.app/docs - Video tutorials: YouTube channel - Interactive tours within platform - Context-sensitive help (? icon)

2. Community Forums - Community discussions - Search common issues - Learn from other users - Share your experiences

3. Blockchain Explorer - seitrace.com for transaction lookups - Verify contract interactions - Check wallet balances - Confirm transaction status

Direct Support Channels

Live Chat (Fastest) - Click chat icon (bottom right of platform) - Available 24/7 for urgent wallet/blockchain issues - Response time: < 5 minutes typically - Best for: Technical problems, urgent issues

Email Support - support@contracting.app - Response time: < 24 hours - Best for: Account issues, billing questions, feature requests

Emergency Contact - emergency@contracting.app - For: Wallet compromise, security breaches, urgent fund-related issues - Response time: < 1 hour - 24/7 availability

Phone Support (Premium) - Available for enterprise customers - Contact your account manager - Video screen sharing available - Advanced troubleshooting

What Information to Provide

When contacting support, include:

Your account email (for verification)
Wallet address (public address only, never private key!)
Transaction hash (if issue involves a transaction)
Screenshots (showing error messages)
Steps to reproduce (what you were doing when issue occurred)
Browser and wallet version (e.g., Chrome 119, MetaMask 11.3)
Network (SEI Mainnet, Testnet, etc.)

NEVER share: - Private keys - Seed phrases - Passwords - Account recovery codes

Emergency Procedures

If You Suspect Your Wallet is Compromised:

⚠️ Immediate Actions: 1. Disconnect wallet from platform immediately 2. Transfer funds to a new wallet ASAP 3. Contact support via emergency line 4. Document any unauthorized transactions 5. Report security incident

After Securing Funds: 1. Create new wallet with new seed phrase 2. Update wallet address in platform 3. Review account activity logs 4. Enable additional security features 5. Consider hardware wallet for future

Prevention: - Never share private keys or seed phrases - Use hardware wallets for large amounts - Enable all available security features - Regular security audits of wallet activity


FAQs

General Questions

Q: Do I have to use blockchain features?
A: No, blockchain deployment is completely optional. You can use the platform with standard off-chain projects. Deploy only when you need immutable records, smart contract automation, or enhanced security.

Q: Is my data private on the blockchain?
A: Yes. Sensitive data is encrypted with RSA-4096 + AES-256-GCM before going on-chain. Only authorized participants can decrypt financial details. Public blockchain explorers only see encrypted data.

Q: What if I lose my wallet?
A: If you have your seed phrase, you can recover your wallet in any compatible wallet software. If you lose both wallet and seed phrase, you cannot access your cryptocurrency or sign transactions for on-chain projects. Always backup your seed phrase!

Q: Can I change my wallet address after connecting?
A: Yes! Go to Settings → Wallet → Disconnect current wallet → Connect new wallet. However, on-chain projects remain associated with the wallet that deployed them.

Q: How do I know if a transaction is safe?
A: Verify the contract address, function being called, and recipient addresses. Never sign if you don't recognize the action. Our platform clearly explains each transaction before you sign.

Cost Questions

Q: Are there monthly fees?
A: No monthly fees for blockchain features. You only pay gas fees when performing blockchain transactions (deploying projects, approving milestones, etc.).

Q: Who pays the gas fees?
A: The person signing the transaction pays. Typically: project creator pays deployment, milestone approvers pay approval fees, payment authorizers pay release fees.

Q: Can I get a refund if a transaction fails?
A: No. Gas fees compensate network validators for processing your transaction, regardless of success or failure. Failed transactions do not change blockchain state, so you can retry.

Q: Why do gas fees vary?
A: Fees depend on network congestion (high demand = higher fees) and transaction complexity (more data = more gas).

Security Questions

Q: Is blockchain really secure?
A: Yes. Blockchain technology uses cryptographic security that's extremely difficult to break. However, YOU must secure your wallet properly - the system is only as secure as your private keys.

Q: What if someone hacks the platform?
A: Your on-chain data is on the blockchain, not our servers. A platform hack cannot alter or steal blockchain data. Your funds are controlled by your wallet keys, not the platform.

Q: Should I use a hardware wallet?
A: For amounts over $5,000 or enterprise use, yes. For smaller amounts and frequent transactions, a browser extension wallet like MetaMask is fine with good security practices.

Technical Questions

Q: What blockchain do you use?
A: SEI Mainnet (Chain ID 1329). We chose SEI for low fees, fast confirmation, and DeFi optimization.

Q: Can I use the testnet first?
A: Yes! Switch to SEI Testnet in your wallet to practice without real money. Contact support to enable testnet mode in your account.

Q: Can I deploy to Ethereum or Polygon?
A: Currently only SEI is supported. Other networks may be added in the future based on demand.

Q: Are the smart contracts audited?
A: Yes. All smart contracts undergo security audits by third-party experts. Contracts are also open-source and available for review on GitHub.

Q: What if there's a bug in the smart contract?
A: Contracts use upgradeable proxy patterns, allowing bug fixes without data loss. Critical functions have admin controls for emergency stops. Consider smart contract insurance for high-value projects.

Project Management Questions

Q: Can I edit a project after blockchain deployment?
A: The original deployment data is immutable, but you can submit revisions (new versions) with updated information. All revisions are recorded on-chain, creating a complete history.

Q: Can I add participants after deployment?
A: Yes! You can add new participants, milestones, and documents after deployment. These create new on-chain transactions that extend the project.

Q: What happens if a participant loses their wallet?
A: If they have their seed phrase, they can recover access. If completely lost, contact support to potentially assign a new wallet. This requires verification and may need approval from other project participants.

Q: Can I delete a blockchain project?
A: No. Blockchain deployments are permanent. However, you can mark projects as closed/completed in the platform interface. The blockchain record remains but the project becomes inactive.

Q: How do I verify my project is on-chain?
A: Look for the "✅ On-Chain" badge. View project details to see contract address, blockchain project ID, and transaction hash. Click "View on Explorer" to see on seitrace.com.


Appendix

Official Resources: - Platform: contracting.app - Documentation: docs.contracting.app - Support: support@contracting.app - GitHub: github.com/yourorg/contracts

Wallet Resources: - MetaMask: metamask.io - Compass: compasswallet.io - Ledger: ledger.com - Trezor: trezor.io

Blockchain Resources: - SEI Documentation: docs.sei.io - SEI Explorer: seitrace.com - SEI Network Status: status.sei.io

Glossary

Address: Public identifier for wallet (e.g., 0x742d35Cc...)
Blockchain: Distributed ledger technology storing immutable records
Gas: Fee paid to process blockchain transactions
MetaMask: Popular browser extension cryptocurrency wallet
Private Key: Secret key proving ownership of wallet
Public Key: Derived from private key, used to generate addresses
Seed Phrase: 12-24 words used to recover wallet
SEI: Blockchain network optimized for DeFi applications
Smart Contract: Self-executing code on the blockchain
Transaction Hash: Unique identifier for blockchain transaction
Wallet: Software/hardware managing cryptographic keys
Web3: Technology enabling decentralized applications


Document Version: 1.0
Last Updated: November 17, 2025
Maintained By: Platform Documentation Team
Feedback: docs-feedback@contracting.app

This guide is updated regularly to reflect the latest features, security practices, and wallet technologies.

← Back to Resources