cb47cce074
- Organized 252 files across project - Root directory: 187 → 2 files (98.9% reduction) - Moved configuration guides to docs/04-configuration/ - Moved troubleshooting guides to docs/09-troubleshooting/ - Moved quick start guides to docs/01-getting-started/ - Moved reports to reports/ directory - Archived temporary files - Generated comprehensive reports and documentation - Created maintenance scripts and guides All files organized according to established standards.
256 lines
6.1 KiB
Bash
Executable File
256 lines
6.1 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Set up MetaMask integration for ChainID 138 with Oracle price feeds
|
|
# Usage: ./setup-metamask-integration.sh
|
|
|
|
set -euo pipefail
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
|
|
|
# Contract addresses
|
|
ORACLE_PROXY="0x3304b747e565a97ec8ac220b0b6a1f6ffdb837e6"
|
|
RPC_URL="https://rpc-core.d-bis.org"
|
|
CHAIN_ID="138"
|
|
|
|
# Colors
|
|
RED='\033[0;31m'
|
|
GREEN='\033[0;32m'
|
|
YELLOW='\033[1;33m'
|
|
BLUE='\033[0;34m'
|
|
NC='\033[0m'
|
|
|
|
log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
|
|
log_success() { echo -e "${GREEN}[✓]${NC} $1"; }
|
|
log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
|
|
log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
|
|
|
|
log_info "========================================="
|
|
log_info "MetaMask Integration Setup"
|
|
log_info "========================================="
|
|
log_info ""
|
|
|
|
# Create MetaMask network configuration
|
|
log_info "Creating MetaMask network configuration..."
|
|
|
|
cat > "$PROJECT_ROOT/docs/METAMASK_NETWORK_CONFIG.json" <<EOF
|
|
{
|
|
"chainId": "0x8a",
|
|
"chainName": "SMOM-DBIS-138",
|
|
"rpcUrls": [
|
|
"$RPC_URL"
|
|
],
|
|
"nativeCurrency": {
|
|
"name": "Ether",
|
|
"symbol": "ETH",
|
|
"decimals": 18
|
|
},
|
|
"blockExplorerUrls": [
|
|
"https://explorer.d-bis.org"
|
|
],
|
|
"iconUrls": [
|
|
"https://raw.githubusercontent.com/ethereum/ethereum.org/main/static/images/eth-diamond-black.png"
|
|
]
|
|
}
|
|
EOF
|
|
|
|
log_success "MetaMask network configuration created"
|
|
|
|
# Create token list for MetaMask
|
|
log_info "Creating token list with Oracle price feed..."
|
|
|
|
cat > "$PROJECT_ROOT/docs/METAMASK_TOKEN_LIST.json" <<EOF
|
|
{
|
|
"name": "SMOM-DBIS-138 Token List",
|
|
"version": {
|
|
"major": 1,
|
|
"minor": 0,
|
|
"patch": 0
|
|
},
|
|
"timestamp": "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)",
|
|
"tokens": [
|
|
{
|
|
"chainId": 138,
|
|
"address": "$ORACLE_PROXY",
|
|
"name": "ETH/USD Price Feed",
|
|
"symbol": "ETH-USD",
|
|
"decimals": 8,
|
|
"logoURI": "https://raw.githubusercontent.com/ethereum/ethereum.org/main/static/images/eth-diamond-black.png"
|
|
}
|
|
]
|
|
}
|
|
EOF
|
|
|
|
log_success "Token list created"
|
|
|
|
# Create Oracle integration guide
|
|
log_info "Creating Oracle integration guide..."
|
|
|
|
cat > "$PROJECT_ROOT/docs/METAMASK_ORACLE_INTEGRATION.md" <<EOF
|
|
# MetaMask Oracle Integration Guide
|
|
|
|
**Date**: $(date)
|
|
**ChainID**: 138
|
|
**Oracle Address**: $ORACLE_PROXY
|
|
|
|
---
|
|
|
|
## 📋 Overview
|
|
|
|
This guide explains how to integrate the deployed Oracle contract with MetaMask for ETH/USD price feeds.
|
|
|
|
---
|
|
|
|
## 🔗 Contract Information
|
|
|
|
- **Oracle Proxy Address**: \`$ORACLE_PROXY\`
|
|
- **ChainID**: 138
|
|
- **RPC Endpoint**: \`$RPC_URL\`
|
|
- **Price Feed**: ETH/USD
|
|
- **Decimals**: 8
|
|
- **Update Frequency**: 60 seconds (heartbeat)
|
|
|
|
---
|
|
|
|
## 📝 MetaMask Network Configuration
|
|
|
|
### Method 1: Manual Configuration
|
|
|
|
1. Open MetaMask
|
|
2. Click network dropdown → "Add Network" → "Add a network manually"
|
|
3. Enter the following:
|
|
- **Network Name**: SMOM-DBIS-138
|
|
- **RPC URL**: \`$RPC_URL\`
|
|
- **Chain ID**: 138
|
|
- **Currency Symbol**: ETH
|
|
- **Block Explorer**: https://explorer.d-bis.org (optional)
|
|
|
|
### Method 2: Import Configuration
|
|
|
|
Use the configuration file: \`docs/METAMASK_NETWORK_CONFIG.json\`
|
|
|
|
---
|
|
|
|
## 💰 Reading Price from Oracle
|
|
|
|
### Using Web3.js
|
|
|
|
\`\`\`javascript
|
|
const Web3 = require('web3');
|
|
const web3 = new Web3('$RPC_URL');
|
|
|
|
// Oracle Proxy ABI (simplified)
|
|
const oracleABI = [
|
|
{
|
|
"inputs": [],
|
|
"name": "latestRoundData",
|
|
"outputs": [
|
|
{"name": "roundId", "type": "uint80"},
|
|
{"name": "answer", "type": "int256"},
|
|
{"name": "startedAt", "type": "uint256"},
|
|
{"name": "updatedAt", "type": "uint256"},
|
|
{"name": "answeredInRound", "type": "uint80"}
|
|
],
|
|
"stateMutability": "view",
|
|
"type": "function"
|
|
}
|
|
];
|
|
|
|
const oracleAddress = '$ORACLE_PROXY';
|
|
const oracle = new web3.eth.Contract(oracleABI, oracleAddress);
|
|
|
|
// Get latest price
|
|
async function getPrice() {
|
|
const result = await oracle.methods.latestRoundData().call();
|
|
const price = result.answer / 1e8; // Convert from 8 decimals to USD
|
|
console.log(\`ETH/USD Price: $\${price}\`);
|
|
return price;
|
|
}
|
|
|
|
getPrice();
|
|
\`\`\`
|
|
|
|
### Using Ethers.js
|
|
|
|
\`\`\`javascript
|
|
const { ethers } = require('ethers');
|
|
|
|
const provider = new ethers.providers.JsonRpcProvider('$RPC_URL');
|
|
|
|
// Oracle Proxy ABI (simplified)
|
|
const oracleABI = [
|
|
"function latestRoundData() external view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)"
|
|
];
|
|
|
|
const oracleAddress = '$ORACLE_PROXY';
|
|
const oracle = new ethers.Contract(oracleAddress, oracleABI, provider);
|
|
|
|
// Get latest price
|
|
async function getPrice() {
|
|
const result = await oracle.latestRoundData();
|
|
const price = result.answer.toNumber() / 1e8; // Convert from 8 decimals to USD
|
|
console.log(\`ETH/USD Price: $\${price}\`);
|
|
return price;
|
|
}
|
|
|
|
getPrice();
|
|
\`\`\`
|
|
|
|
---
|
|
|
|
## 🔄 Oracle Publisher Service
|
|
|
|
The Oracle Publisher service (VMID 3500) automatically updates the Oracle contract with price feeds.
|
|
|
|
**Configuration**:
|
|
- **Service**: Oracle Publisher
|
|
- **VMID**: 3500
|
|
- **Update Interval**: 60 seconds
|
|
- **Price Source**: External API (e.g., CoinGecko, CoinMarketCap)
|
|
|
|
---
|
|
|
|
## ✅ Verification
|
|
|
|
### Check Oracle is Updating
|
|
|
|
\`\`\`bash
|
|
# Query latest round data
|
|
cast call $ORACLE_PROXY "latestRoundData()" --rpc-url $RPC_URL
|
|
\`\`\`
|
|
|
|
### Check Update Frequency
|
|
|
|
The Oracle should update every 60 seconds (heartbeat). Monitor the \`updatedAt\` timestamp to verify.
|
|
|
|
---
|
|
|
|
## 📚 Additional Resources
|
|
|
|
- Oracle Contract: \`$ORACLE_PROXY\`
|
|
- Network Config: \`docs/METAMASK_NETWORK_CONFIG.json\`
|
|
- Token List: \`docs/METAMASK_TOKEN_LIST.json\`
|
|
|
|
---
|
|
|
|
**Last Updated**: $(date)
|
|
EOF
|
|
|
|
log_success "Oracle integration guide created"
|
|
|
|
log_info ""
|
|
log_success "========================================="
|
|
log_success "MetaMask Integration Setup Complete!"
|
|
log_success "========================================="
|
|
log_info ""
|
|
log_info "Created files:"
|
|
log_info " - docs/METAMASK_NETWORK_CONFIG.json"
|
|
log_info " - docs/METAMASK_TOKEN_LIST.json"
|
|
log_info " - docs/METAMASK_ORACLE_INTEGRATION.md"
|
|
log_info ""
|
|
log_info "Next steps:"
|
|
log_info "1. Add network to MetaMask using the configuration file"
|
|
log_info "2. Verify Oracle Publisher service is updating prices"
|
|
log_info "3. Test reading price from Oracle contract"
|
|
log_info ""
|
|
|