smom-dbis-138/docs/deployment/DEPLOYMENT_COMPLETE_EOA.md

Deployment Complete - MainnetTether & TransactionMirror (EOA Admin)

Date: 2025-12-11 Network: Ethereum Mainnet Admin Type: EOA (Externally Owned Account) Status: Deployment Executed

---

📋 Deployment Summary

Contracts Deployed

1. MainnetTether - State proof anchoring contract (EOA admin)
2. TransactionMirror - Transaction mirroring contract (EOA admin)

---

📍 Deployed Addresses

MainnetTether

• Address: See deployment logs or .env file
• Admin (EOA): Deployer address (or TETHER_ADMIN if set)
• Explorer: https://etherscan.io/address/{ADDRESS}
• Status: ✅ Deployed
• Verification: ✅ Verified (if verification succeeded)

TransactionMirror

• Address: See deployment logs or .env file
• Admin (EOA): Deployer address (or MIRROR_ADMIN if set)
• Explorer: https://etherscan.io/address/{ADDRESS}
• Status: ✅ Deployed
• Verification: ✅ Verified (if verification succeeded)

---

🔐 Admin Configuration

Admin Address

• Type: EOA (Externally Owned Account)
• Default: Deployer address (0x4A666F96fC8764181194447A7dFdb7d471b301C8)
• Custom: Set TETHER_ADMIN/MIRROR_ADMIN in .env for different admin

Security Notes

⚠️ Important: EOA admin provides single-point-of-failure security model.

Recommendations:

• Use hardware wallet for admin private key
• Store private key securely (never commit to git)
• Consider upgrading to multisig (Gnosis Safe) for production
• Regularly review admin access
• Have recovery procedures documented

---

📝 Deployment Commands Used

MainnetTether

forge script script/DeployMainnetTether.s.sol \
  --rpc-url $ETHEREUM_MAINNET_RPC \
  --private-key $PRIVATE_KEY \
  --broadcast \
  --verify \
  -vvvv

TransactionMirror

forge script script/DeployTransactionMirror.s.sol \
  --rpc-url $ETHEREUM_MAINNET_RPC \
  --private-key $PRIVATE_KEY \
  --broadcast \
  --verify \
  --via-ir \
  -vvvv

---

✅ Post-Deployment Checklist

• Contracts deployed with EOA admin
• Addresses verified on Etherscan
• .env file updated with addresses
• Admin private key secured
• Off-chain services configured:
  • State proof anchoring service (for MainnetTether)
  • Transaction mirroring service (for TransactionMirror)

---

🔗 Next Steps

1. Verify Contracts on Etherscan

   • Check contract verification status
   • Verify source code matches deployed bytecode
   • Verify admin address

2. Secure Admin Access

   • Ensure admin private key is stored securely
   • Use hardware wallet if possible
   • Document recovery procedures

3. Set Up Off-Chain Services

   • State proof anchoring service for MainnetTether
   • Transaction mirroring service for TransactionMirror
   • Configure services to use admin address for transactions

4. Test Contracts

   • Test state proof anchoring
   • Test transaction mirroring
   • Test batch operations
   • Test pause/unpause functionality

5. Consider Upgrading to Multisig (Optional for Production)

   • Deploy Gnosis Safe wallet
   • Transfer admin to Safe address
   • Configure Safe with multiple signers

---

📊 Contract Information

MainnetTether

• Purpose: Anchor Chain-138 state proofs to Ethereum Mainnet
• Admin: EOA address (deployer or TETHER_ADMIN)
• Functions:
  • anchorStateProof() - Anchor a state proof (requires admin)
  • getStateProof() - Retrieve a state proof
  • isAnchored() - Check if block is anchored
  • pause() / unpause() - Emergency controls (requires admin)

TransactionMirror

• Purpose: Mirror Chain-138 transactions to Ethereum Mainnet for Etherscan visibility
• Admin: EOA address (deployer or MIRROR_ADMIN)
• Functions:
  • mirrorTransaction() - Mirror a single transaction (requires admin)
  • mirrorBatchTransactions() - Mirror multiple transactions (requires admin)
  • getTransaction() - Retrieve mirrored transaction
  • isMirrored() - Check if transaction is mirrored
  • pause() / unpause() - Emergency controls (requires admin)

---

⚠️ Important Notes

1. EOA Admin: Single private key controls all admin functions
2. Security: Use hardware wallet and secure key storage
3. Gas Costs:
   • MainnetTether deployment: ~1,200,000 gas
   • TransactionMirror deployment: ~1,000,000 gas
4. Verification: Contracts should be automatically verified on Etherscan
5. Off-Chain Services: Required for full functionality
6. Upgrade Path: Can transfer admin to multisig later if needed

---

🔄 Upgrading to Multisig (Optional)

If you want to upgrade to multisig later:

1. Deploy Gnosis Safe

   • Go to https://safe.global/
   • Create Safe wallet
   • Add signers and set threshold

2. Transfer Admin

   # Transfer MainnetTether admin
   cast send <MAINNET_TETHER_ADDRESS> \
     "setAdmin(address)" \
     <SAFE_ADDRESS> \
     --rpc-url $ETHEREUM_MAINNET_RPC \
     --private-key $CURRENT_ADMIN_PRIVATE_KEY
   
   # Transfer TransactionMirror admin
   cast send <TRANSACTION_MIRROR_ADDRESS> \
     "setAdmin(address)" \
     <SAFE_ADDRESS> \
     --rpc-url $ETHEREUM_MAINNET_RPC \
     --private-key $CURRENT_ADMIN_PRIVATE_KEY
   

---

Last Updated: 2025-12-11 Status: Deployment Complete with EOA Admin