Files
metamask-integration/docs/QUICK_START_DEPLOYMENT.md
2026-03-02 12:14:14 -08:00

3.6 KiB

Quick Start Deployment Guide - Smart Accounts

Date: 2026-01-26
Network: ChainID 138 (SMOM-DBIS-138)


Overview

This guide provides a quick start for deploying Smart Accounts Kit on ChainID 138.


Prerequisites

Required

  • Foundry: Installed and configured
  • Node.js: v18 or higher
  • RPC Access: Access to ChainID 138 RPC endpoint
  • ETH Balance: Sufficient ETH for gas fees

Environment Setup

  1. Set up environment variables in smom-dbis-138/.env:

    RPC_URL_138=https://rpc.d-bis.org
    PRIVATE_KEY=your_private_key_here
    
  2. Verify prerequisites:

    forge --version
    node --version
    

Quick Deployment (5 Steps)

Step 1: Install SDK

cd metamask-integration
./scripts/install-smart-accounts-sdk.sh

Step 2: Deploy Smart Accounts Kit Contracts

cd ../smom-dbis-138
forge script script/smart-accounts/DeploySmartAccountsKit.s.sol \
  --rpc-url $RPC_URL_138 \
  --broadcast \
  --verify

Record the deployed addresses:

  • EntryPoint address
  • AccountFactory address
  • Paymaster address (if deployed)

Step 3: Update Configuration

cd ../metamask-integration
./scripts/update-smart-accounts-config.sh --interactive

Enter the deployed contract addresses when prompted.

Step 4: Deploy AccountWalletRegistryExtended

cd ../smom-dbis-138
# Set environment variables first
export SMART_ACCOUNT_FACTORY=<AccountFactory address>
export ENTRY_POINT=<EntryPoint address>

forge script script/smart-accounts/DeployAccountWalletRegistryExtended.s.sol \
  --rpc-url $RPC_URL_138 \
  --broadcast \
  --verify

Step 5: Verify Deployment

cd ../metamask-integration
./scripts/verify-deployment.sh
./scripts/health-check.sh

Automated Deployment

For a fully automated deployment:

cd metamask-integration
./scripts/deploy-smart-accounts-complete.sh

Note: You'll still need to manually update configuration with contract addresses after deployment.


Post-Deployment

1. Setup Monitoring

./scripts/setup-monitoring.sh

2. Run Tests

# Unit tests
cd ../smom-dbis-138
forge test --match-path test/smart-accounts/** -vv

# Integration tests
cd ../metamask-integration
npm test

3. Validate Configuration

./scripts/validate-config.sh

Verification Checklist

  • SDK installed
  • Contracts deployed
  • Configuration updated
  • AccountWalletRegistryExtended deployed
  • Health check passed
  • Tests passing
  • Monitoring configured

Troubleshooting

Common Issues

Issue: RPC connection failed

  • Solution: Verify RPC_URL_138 is correct and accessible

Issue: Insufficient gas

  • Solution: Ensure deployer address has sufficient ETH

Issue: Contract verification failed

  • Solution: Check block explorer API key and network connectivity

Issue: Configuration validation failed

  • Solution: Run ./scripts/validate-config.sh to identify issues

Next Steps

  1. Security Audit: Review Security Audit Preparation
  2. Testing: Follow Testing Guide
  3. Monitoring: Setup monitoring per Infrastructure Setup
  4. Documentation: Review all guides in docs/ directory

Resources


Last Updated: 2026-01-26