1. 블록체인 개발자를 위한 API와 SDK가 필요한 이유 🤔

블록체인 기술은 정말 멋지지만, 솔직히 말하면 복잡하기도 해. 이더리움 같은 블록체인과 직접 소통하려면 RPC(Remote Procedure Call) 호출, 16진수 데이터 처리, 암호화 서명 등 여러 저수준 작업을 해야 하거든. 이런 복잡한 과정을 쉽게 만들어주는 게 바로 API(Application Programming Interface)와 SDK(Software Development Kit)야!

API와 SDK를 사용하면 얻을 수 있는 장점들을 살펴볼까?

1. 개발 시간 단축: 복잡한 블록체인 상호작용을 몇 줄의 코드로 처리할 수 있어.
2. 실수 감소: 검증된 라이브러리를 사용하면 오류 가능성이 줄어들지.
3. 최신 기능 활용: 라이브러리가 업데이트되면 새로운 블록체인 기능도 쉽게 사용할 수 있어.
4. 커뮤니티 지원: 많은 개발자들이 사용하는 도구라서 문제 해결이 쉬워.
5. 크로스 플랫폼 지원: 웹, 모바일, 서버 등 다양한 환경에서 일관된 방식으로 개발 가능해.

요즘 재능넷 같은 플랫폼에서도 블록체인 개발 관련 재능 거래가 늘고 있는데, 이런 API와 SDK를 능숙하게 다루는 스킬은 정말 가치 있는 재능이 되고 있어! 이제 구체적인 도구들을 하나씩 살펴볼까?

2. Web3.js 완전 정복 🌐

2.1 Web3.js 설치하기

먼저 Web3.js를 설치해볼까? npm을 사용한다면 아래 명령어로 쉽게 설치할 수 있어:

npm install web3

또는 yarn을 사용한다면:

yarn add web3

CDN을 통해 직접 웹페이지에 포함시킬 수도 있어:

<script src="https://cdn.jsdelivr.net/npm/web3@latest/dist/web3.min.js"></script>

2.2 Web3.js 기본 사용법

Web3.js를 사용하려면 먼저 Web3 인스턴스를 생성하고 이더리움 노드에 연결해야 해:

// Web3 인스턴스 생성
const Web3 = require('web3');
const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_KEY');

// 또는 브라우저에서 MetaMask를 사용할 경우
if (window.ethereum) {
    window.web3 = new Web3(window.ethereum);
    try {
        // 사용자에게 계정 접근 권한 요청
        await window.ethereum.enable();
    } catch (error) {
        console.error("사용자가 계정 접근을 거부했습니다.");
    }
}

이제 Web3.js의 주요 기능들을 살펴볼게:

2.2.1 계정 정보 조회하기

// 연결된 계정 목록 가져오기
const accounts = await web3.eth.getAccounts();
console.log("내 계정 주소:", accounts[0]);

// 계정 잔액 확인하기
const balance = await web3.eth.getBalance(accounts[0]);
console.log("잔액(Wei):", balance);
console.log("잔액(ETH):", web3.utils.fromWei(balance, 'ether'));

2.2.2 트랜잭션 보내기

// ETH 전송하기
const sendTransaction = async () => {
    const result = await web3.eth.sendTransaction({
        from: accounts[0],
        to: '0x수신자주소',
        value: web3.utils.toWei('0.1', 'ether')
    });
    console.log("트랜잭션 해시:", result.transactionHash);
};

2.2.3 스마트 컨트랙트 상호작용

// 컨트랙트 ABI와 주소
const contractABI = [...]; // 컨트랙트 ABI
const contractAddress = '0x컨트랙트주소';

// 컨트랙트 인스턴스 생성
const contract = new web3.eth.Contract(contractABI, contractAddress);

// 컨트랙트 함수 호출 (읽기 전용)
const result = await contract.methods.balanceOf(accounts[0]).call();
console.log("토큰 잔액:", result);

// 컨트랙트 함수 호출 (상태 변경)
const tx = await contract.methods.transfer('0x수신자주소', '1000000000000000000').send({
    from: accounts[0]
});
console.log("전송 완료:", tx.transactionHash);

2.3 Web3.js의 주요 모듈

1. web3.eth: 이더리움 블록체인과 상호작용하는 함수들이 포함되어 있어.
2. web3.utils: 단위 변환(Wei ↔ ETH), 해시 생성 등의 유틸리티 함수가 있어.
3. web3.net: 네트워크 상태 확인 기능을 제공해.
4. web3.shh: Whisper 프로토콜을 위한 기능이 있어 (P2P 통신용).

Web3.js는 블록체인 개발의 기초가 되는 라이브러리야. 이걸 잘 다루면 재능넷에서도 블록체인 개발 관련 재능을 충분히 뽐낼 수 있을 거야! 하지만 Web3.js만이 유일한 선택지는 아니야. 다음으로 ethers.js라는 강력한 대안을 살펴보자.

3. ethers.js로 더 쉬운 이더리움 개발하기 ⚡

3.1 ethers.js 설치하기

ethers.js도 npm이나 yarn을 통해 쉽게 설치할 수 있어:

npm install ethers

또는:

yarn add ethers

CDN을 통한 설치:

<script src="https://cdn.ethers.io/lib/ethers-5.0.umd.min.js" type="application/javascript"></script>

3.2 ethers.js 기본 사용법

ethers.js는 Web3.js와 비슷하지만, 구조가 좀 더 명확하게 분리되어 있어. 주요 구성 요소는 다음과 같아:

1. Provider: 블록체인에 대한 읽기 전용 연결을 제공해.
2. Signer: 개인 키를 관리하고 트랜잭션에 서명하는 역할을 해.
3. Contract: 스마트 컨트랙트와 상호작용하기 위한 인터페이스야.
4. Utils: 다양한 유틸리티 함수들을 제공해.

기본적인 사용 예시를 살펴볼게:

// ethers.js 불러오기
const { ethers } = require("ethers");

// 프로바이더 연결하기
const provider = new ethers.providers.JsonRpcProvider("https://mainnet.infura.io/v3/YOUR_INFURA_KEY");

// 또는 브라우저에서 MetaMask 사용하기
const provider = new ethers.providers.Web3Provider(window.ethereum);

// 사용자에게 지갑 연결 권한 요청하기
await provider.send("eth_requestAccounts", []);

// 서명자(Signer) 가져오기
const signer = provider.getSigner();

3.2.1 계정 정보 조회하기

// 연결된 계정 주소 가져오기
const address = await signer.getAddress();
console.log("내 계정 주소:", address);

// 계정 잔액 확인하기
const balance = await provider.getBalance(address);
console.log("잔액(Wei):", balance.toString());
console.log("잔액(ETH):", ethers.utils.formatEther(balance));

3.2.2 트랜잭션 보내기

// ETH 전송하기
const sendTransaction = async () => {
    const tx = await signer.sendTransaction({
        to: '0x수신자주소',
        value: ethers.utils.parseEther('0.1')
    });
    console.log("트랜잭션 해시:", tx.hash);
    
    // 트랜잭션 완료 대기
    const receipt = await tx.wait();
    console.log("트랜잭션 완료! 블록 번호:", receipt.blockNumber);
};

3.2.3 스마트 컨트랙트 상호작용

// 컨트랙트 ABI와 주소
const contractABI = [...]; // 컨트랙트 ABI
const contractAddress = '0x컨트랙트주소';

// 읽기 전용 컨트랙트 인스턴스 생성
const readOnlyContract = new ethers.Contract(contractAddress, contractABI, provider);

// 쓰기 가능한 컨트랙트 인스턴스 생성
const writableContract = new ethers.Contract(contractAddress, contractABI, signer);

// 컨트랙트 함수 호출 (읽기 전용)
const balance = await readOnlyContract.balanceOf(address);
console.log("토큰 잔액:", ethers.utils.formatUnits(balance, 18));

// 컨트랙트 함수 호출 (상태 변경)
const tx = await writableContract.transfer('0x수신자주소', ethers.utils.parseUnits('1', 18));
console.log("전송 트랜잭션 해시:", tx.hash);
await tx.wait();
console.log("전송 완료!");

3.3 Web3.js와 ethers.js 비교

두 라이브러리 모두 훌륭하지만, 몇 가지 차이점이 있어:

1. 구조: ethers.js는 Provider와 Signer를 명확히 분리해서 보안성이 높아.
2. 크기: ethers.js가 더 가볍고 모듈화가 잘 되어 있어.
3. 문법: ethers.js는 더 현대적인 JavaScript 패턴을 따르고 있어.
4. 커뮤니티: Web3.js는 더 오래되어서 자료가 많지만, ethers.js도 빠르게 성장 중이야.

어떤 라이브러리를 선택할지는 프로젝트 요구사항과 개인 취향에 따라 달라질 수 있어. 둘 다 배워두면 블록체인 개발에 큰 도움이 될 거야! 이제 이 라이브러리들을 더 효과적으로 사용할 수 있게 해주는 인프라 서비스인 Alchemy와 Infura에 대해 알아보자.

4. Alchemy: 블록체인 개발의 강력한 동반자 🧙‍♂️

4.1 Alchemy 시작하기

Alchemy를 사용하려면 먼저 회원가입을 하고 API 키를 발급받아야 해:

1. Alchemy 웹사이트(https://www.alchemy.com/)에 접속해서 회원가입을 해.
2. 대시보드에서 새 앱(App)을 생성해.
3. 네트워크(이더리움 메인넷, 테스트넷 등)를 선택해.
4. 생성된 API 키를 복사해두자.

4.2 Alchemy SDK 사용하기

Alchemy는 자체 SDK를 제공하지만, Web3.js나 ethers.js와 함께 사용할 수도 있어:

// Alchemy SDK 설치
npm install alchemy-sdk

// Alchemy SDK 사용하기
const { Alchemy, Network } = require("alchemy-sdk");

const config = {
    apiKey: "YOUR_ALCHEMY_API_KEY",
    network: Network.ETH_MAINNET,
};
const alchemy = new Alchemy(config);

// 최근 블록 번호 가져오기
const latestBlock = await alchemy.core.getBlockNumber();
console.log("최근 블록:", latestBlock);

4.3 ethers.js와 Alchemy 함께 사용하기

const { ethers } = require("ethers");

// Alchemy 프로바이더 생성
const provider = new ethers.providers.AlchemyProvider(
    "mainnet",
    "YOUR_ALCHEMY_API_KEY"
);

// 이더리움 가스 가격 확인하기
const gasPrice = await provider.getGasPrice();
console.log("현재 가스 가격:", ethers.utils.formatUnits(gasPrice, "gwei"), "Gwei");

4.4 Alchemy의 특별한 기능들

Alchemy는 기본적인 노드 서비스 외에도 다양한 특화 기능을 제공해:

1. NFT API: NFT 메타데이터, 소유권 정보 등을 쉽게 조회할 수 있어.
2. Notify: 특정 이벤트가 발생하면 웹훅으로 알림을 받을 수 있어.
3. Mempool 시각화: 트랜잭션 처리 과정을 시각적으로 모니터링할 수 있어.
4. Enhanced APIs: 토큰 잔액 일괄 조회 등 최적화된 API를 제공해.
5. Debug Toolkit: 트랜잭션 디버깅을 위한 강력한 도구를 제공해.

예를 들어, NFT API를 사용하는 방법은 다음과 같아:

// NFT 메타데이터 가져오기
const nftMetadata = await alchemy.nft.getNftMetadata(
    "0xContractAddress",
    "tokenId"
);
console.log("NFT 메타데이터:", nftMetadata);

// 특정 주소가 소유한 NFT 목록 가져오기
const nfts = await alchemy.nft.getNftsForOwner("0x소유자주소");
console.log("소유한 NFT 수:", nfts.totalCount);

Alchemy는 무료 티어를 제공하기 때문에 개인 프로젝트나 학습용으로 시작하기 좋아. 특히 NFT 프로젝트를 개발하고 있다면 Alchemy의 특화된 API가 큰 도움이 될 거야! 다음으로는 또 다른 인기 있는 블록체인 인프라 서비스인 Infura에 대해 알아보자.

5. Infura: 안정적인 블록체인 인프라 서비스 🏗️

5.1 Infura 시작하기

Infura를 사용하려면 Alchemy와 마찬가지로 회원가입 후 API 키를 발급받아야 해:

1. Infura 웹사이트(https://infura.io/)에 접속해서 회원가입을 해.
2. 대시보드에서 새 프로젝트를 생성해.
3. 이더리움 API를 선택하고 원하는 네트워크를 설정해.
4. 생성된 프로젝트 ID(API 키)를 복사해두자.

5.2 Web3.js와 Infura 함께 사용하기

const Web3 = require('web3');

// Infura 엔드포인트로 Web3 인스턴스 생성
const web3 = new Web3(new Web3.providers.HttpProvider(
    'https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID'
));

// 최근 블록 번호 가져오기
web3.eth.getBlockNumber()
    .then(blockNumber => {
        console.log("최근 블록 번호:", blockNumber);
    });

5.3 ethers.js와 Infura 함께 사용하기

const { ethers } = require("ethers");

// Infura 프로바이더 생성
const provider = new ethers.providers.InfuraProvider(
    "mainnet",
    "YOUR_INFURA_PROJECT_ID"
);

// 이더리움 가스 가격 확인하기
async function checkGasPrice() {
    const gasPrice = await provider.getGasPrice();
    console.log("현재 가스 가격:", ethers.utils.formatUnits(gasPrice, "gwei"), "Gwei");
}

checkGasPrice();

5.4 Infura의 주요 기능

1. 다양한 네트워크 지원: 이더리움 메인넷, 테스트넷, L2 솔루션(Polygon, Optimism 등) 지원
2. IPFS 서비스: 분산 파일 저장 시스템인 IPFS에 대한 접근 제공
3. 트랜잭션 API: 트랜잭션 전송 및 관리를 위한 API 제공
4. WebSocket 지원: 실시간 이벤트 구독을 위한 WebSocket 연결 지원
5. 대시보드: API 사용량 모니터링 및 관리 도구 제공

WebSocket을 사용한 실시간 이벤트 구독 예시:

// Web3.js와 Infura WebSocket 사용하기
const Web3 = require('web3');
const web3 = new Web3(new Web3.providers.WebsocketProvider(
    'wss://mainnet.infura.io/ws/v3/YOUR_INFURA_PROJECT_ID'
));

// 새 블록 이벤트 구독하기
web3.eth.subscribe('newBlockHeaders', (error, blockHeader) => {
    if (!error) {
        console.log("새 블록 생성:", blockHeader.number);
    } else {
        console.error("오류 발생:", error);
    }
});

IPFS를 통한 파일 업로드 예시 (Infura의 IPFS API 사용):

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

async function uploadToIPFS(filePath) {
    const formData = new FormData();
    formData.append('file', fs.createReadStream(filePath));
    
    const response = await axios.post(
        'https://ipfs.infura.io:5001/api/v0/add',
        formData,
        {
            headers: {
                ...formData.getHeaders(),
                'Authorization': 'Basic ' + Buffer.from(
                    'YOUR_INFURA_IPFS_PROJECT_ID:YOUR_INFURA_IPFS_PROJECT_SECRET'
                ).toString('base64')
            }
        }
    );
    
    console.log("IPFS 해시:", response.data.Hash);
    return response.data.Hash;
}

5.5 Alchemy vs Infura: 어떤 것을 선택해야 할까?

두 서비스 모두 훌륭하지만, 프로젝트 요구사항에 따라 선택이 달라질 수 있어:

1. Infura 선택 이유:
   • IPFS 서비스가 필요한 경우
   • ConsenSys 생태계의 다른 도구들과 함께 사용하는 경우
   • 간단한 노드 접근만 필요한 경우
2. Alchemy 선택 이유:
   • NFT 관련 기능이 필요한 경우
   • 고급 디버깅 도구가 필요한 경우
   • 더 많은 개발자 도구와 분석 기능이 필요한 경우

두 서비스 모두 무료 티어를 제공하기 때문에 직접 사용해보고 비교해보는 것도 좋은 방법이야. 재능넷에서 블록체인 개발 관련 재능을 찾고 있다면, 이런 인프라 서비스에 익숙한 개발자를 만나볼 수 있을 거야!

6. API와 SDK 비교 및 선택 가이드 🧐

6.1 라이브러리 선택 가이드: Web3.js vs ethers.js

Web3.js를 선택해야 할 때:

1. 이미 Web3.js를 사용하는 프로젝트를 유지보수할 때
2. 광범위한 커뮤니티 지원과 레퍼런스가 필요할 때
3. 이더리움 재단의 공식 라이브러리를 사용하고 싶을 때

ethers.js를 선택해야 할 때:

1. 더 작고 모듈화된 라이브러리를 원할 때
2. 보안에 더 중점을 두고 싶을 때 (Provider와 Signer 분리)
3. 더 현대적인 JavaScript 패턴(Promise, async/await)을 선호할 때
4. ENS(Ethereum Name Service) 통합이 중요할 때

6.2 인프라 서비스 선택 가이드: Alchemy vs Infura

Alchemy를 선택해야 할 때:

1. NFT 관련 프로젝트를 개발할 때
2. 고급 디버깅 도구와 모니터링이 필요할 때
3. 개선된 API(토큰 잔액 일괄 조회 등)가 필요할 때
4. Notify 같은 웹훅 기능이 필요할 때

Infura를 선택해야 할 때:

1. IPFS 서비스가 필요할 때
2. 간단하고 안정적인 노드 접근만 필요할 때
3. MetaMask와의 통합이 중요할 때 (MetaMask는 기본적으로 Infura 사용)
4. ConsenSys 생태계의 다른 도구들과 함께 사용할 때

6.3 최적의 조합 찾기

라이브러리와 인프라 서비스는 독립적으로 선택할 수 있어. 다음과 같은 조합이 가능해:

1. Web3.js + Infura: 전통적인 조합으로, 많은 레퍼런스 존재
2. Web3.js + Alchemy: 익숙한 라이브러리와 고급 기능 조합
3. ethers.js + Infura: 현대적 라이브러리와 안정적 인프라
4. ethers.js + Alchemy: 최신 기술 스택 조합, 특히 NFT 프로젝트에 적합

6.4 실제 사용 사례 분석

실제 프로젝트에서는 어떤 조합이 사용되고 있을까?

1. OpenSea: Web3.js + 자체 인프라 + Infura
2. Uniswap: ethers.js + Infura
3. Aave: ethers.js + 여러 인프라 서비스 조합
4. Metamask: ethers.js + Infura

대부분의 대형 프로젝트들은 단일 인프라에 의존하지 않고 여러 서비스를 조합해서 사용하는 경향이 있어. 이는 서비스 중단 위험을 분산시키기 위한 전략이야. 개인 프로젝트나 학습 목적이라면 하나의 서비스로 시작해도 충분해!

7. 실전 프로젝트: 간단한 DApp 만들기 🛠️

7.1 프로젝트 설정

먼저 필요한 패키지를 설치하고 기본 구조를 만들어보자:

// 프로젝트 폴더 생성 및 초기화
mkdir eth-balance-checker
cd eth-balance-checker
npm init -y

// 필요한 패키지 설치
npm install ethers dotenv express

환경 변수를 관리하기 위한 .env 파일을 생성해:

ALCHEMY_API_KEY=your_alchemy_api_key_here
PORT=3000

7.2 서버 코드 작성

server.js 파일을 만들어 간단한 Express 서버를 구성해보자:

// server.js
require('dotenv').config();
const express = require('express');
const path = require('path');
const { ethers } = require('ethers');

const app = express();
const port = process.env.PORT || 3000;

// 정적 파일 제공
app.use(express.static('public'));
app.use(express.json());

// Alchemy 프로바이더 설정
const provider = new ethers.providers.AlchemyProvider(
    'mainnet',
    process.env.ALCHEMY_API_KEY
);

// API 엔드포인트: 계정 잔액 조회
app.get('/api/balance/:address', async (req, res) => {
    try {
        const address = req.params.address;
        
        // 주소 유효성 검사
        if (!ethers.utils.isAddress(address)) {
            return res.status(400).json({ error: '유효하지 않은 이더리움 주소입니다.' });
        }
        
        // 잔액 조회
        const balance = await provider.getBalance(address);
        const etherBalance = ethers.utils.formatEther(balance);
        
        // 이더 가격 (실제로는 API를 통해 가져와야 함)
        const etherPrice = 3000; // USD
        const usdBalance = parseFloat(etherBalance) * etherPrice;
        
        res.json({
            address,
            balance: etherBalance,
            usdBalance: usdBalance.toFixed(2)
        });
    } catch (error) {
        console.error('Error:', error);
        res.status(500).json({ error: '서버 오류가 발생했습니다.' });
    }
});

// 메인 페이지 제공
app.get('/', (req, res) => {
    res.sendFile(path.join(__dirname, 'public', 'index.html'));
});

// 서버 시작
app.listen(port, () => {
    console.log(`서버가 http://localhost:${port} 에서 실행 중입니다.`);
});

7.3 프론트엔드 코드 작성

public 폴더를 만들고 그 안에 index.html 파일을 생성해:

<!DOCTYPE html>
<html lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>이더리움 잔액 조회기</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            max-width: 800px;
            margin: 0 auto;
            padding: 20px;
        }
        .container {
            background-color: #f5f5f5;
            border-radius: 10px;
            padding: 20px;
            box-shadow: 0 4px 6px rgba(0,0,0,0.1);
        }
        h1 {
            color: #333;
            text-align: center;
        }
        .form-group {
            margin-bottom: 15px;
        }
        label {
            display: block;
            margin-bottom: 5px;
            font-weight: bold;
        }
        input[type="text"] {
            width: 100%;
            padding: 8px;
            border: 1px solid #ddd;
            border-radius: 4px;
            box-sizing: border-box;
        }
        button {
            background-color: #4CAF50;
            color: white;
            padding: 10px 15px;
            border: none;
            border-radius: 4px;
            cursor: pointer;
            font-size: 16px;
        }
        button:hover {
            background-color: #45a049;
        }
        .result {
            margin-top: 20px;
            padding: 15px;
            background-color: #e8f5e9;
            border-radius: 4px;
            display: none;
        }
        .error {
            color: red;
            margin-top: 10px;
            display: none;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>이더리움 잔액 조회기</h1>
        <div class="form-group">
            <label for="address">이더리움 주소:</label>
            <input type="text" id="address" placeholder="0x로 시작하는 이더리움 주소를 입력하세요">
        </div>
        <button id="check-balance">잔액 확인</button>
        
        <div id="error" class="error"></div>
        
        <div id="result" class="result">
            <h3>조회 결과</h3>
            <p><strong>주소:</strong> <span id="result-address"></span></p>
            <p><strong>ETH 잔액:</strong> <span id="result-balance"></span> ETH</p>
            <p><strong>USD 가치:</strong> $<span id="result-usd"></span></p>
        </div>
    </div>

    <script>
        document.getElementById('check-balance').addEventListener('click', async () => {
            const addressInput = document.getElementById('address').value.trim();
            const errorDiv = document.getElementById('error');
            const resultDiv = document.getElementById('result');
            
            // 입력 초기화
            errorDiv.style.display = 'none';
            resultDiv.style.display = 'none';
            
            if (!addressInput) {
                errorDiv.textContent = '이더리움 주소를 입력해주세요.';
                errorDiv.style.display = 'block';
                return;
            }
            
            try {
                const response = await fetch(`/api/balance/${addressInput}`);
                const data = await response.json();
                
                if (response.ok) {
                    // 결과 표시
                    document.getElementById('result-address').textContent = data.address;
                    document.getElementById('result-balance').textContent = data.balance;
                    document.getElementById('result-usd').textContent = data.usdBalance;
                    resultDiv.style.display = 'block';
                } else {
                    // 오류 표시
                    errorDiv.textContent = data.error || '잔액 조회 중 오류가 발생했습니다.';
                    errorDiv.style.display = 'block';
                }
            } catch (error) {
                console.error('Error:', error);
                errorDiv.textContent = '서버 연결 중 오류가 발생했습니다.';
                errorDiv.style.display = 'block';
            }
        });
    </script>
</body>
</html>

7.4 프로젝트 실행

이제 서버를 실행해보자:

node server.js

브라우저에서 http://localhost:3000 에 접속하면 우리가 만든 이더리움 잔액 조회기를 사용할 수 있어!

7.5 프로젝트 확장 아이디어

이 기본 프로젝트를 더 발전시킬 수 있는 방법들이야:

1. ERC-20 토큰 잔액 조회 기능 추가하기
2. NFT 소유 목록 표시하기 (Alchemy NFT API 활용)
3. MetaMask 연동으로 사용자 지갑 직접 연결하기
4. 트랜잭션 히스토리 조회 기능 추가하기
5. 가스 가격 모니터링 기능 추가하기

이런 프로젝트를 만들어보면서 실제로 API와 SDK를 활용하는 방법을 익히면, 재능넷 같은 플랫폼에서도 블록체인 개발 관련 재능을 더 효과적으로 발휘할 수 있을 거야! 직접 만들어보고 GitHub에 공유하면 포트폴리오로도 활용할 수 있어.

8. 자주 묻는 질문과 문제 해결 ❓

8.1 일반적인 문제와 해결책

8.2 Web3.js 관련 FAQ

// 문자열로 큰 숫자 전달하기
const amount = web3.utils.toWei('1.5', 'ether');

// 숫자 비교하기
const balance = await web3.eth.getBalance(address);
if (web3.utils.toBN(balance).gte(web3.utils.toBN(amount))) {
    console.log("잔액이 충분합니다!");
}

const web3 = new Web3(new Web3.providers.WebsocketProvider(
    'wss://mainnet.infura.io/ws/v3/YOUR_INFURA_KEY'
));

// 컨트랙트 이벤트 구독
const contract = new web3.eth.Contract(ABI, contractAddress);
contract.events.Transfer({
    filter: { to: myAddress }
})
.on('data', event => console.log('받은 토큰:', event.returnValues))
.on('error', error => console.error('오류:', error));

8.3 ethers.js 관련 FAQ

// 이벤트 필터 생성
const filter = contract.filters.Transfer(null, myAddress);

// 과거 이벤트 조회
const events = await contract.queryFilter(filter, -1000, 'latest');
console.log('최근 1000블록 내 받은 토큰:', events);

// 이벤트 구독
contract.on(filter, (from, to, amount, event) => {
    console.log(`${from}에서 ${to}로 ${ethers.utils.formatEther(amount)} 토큰 전송됨`);
});

// 트랜잭션 보내기
const tx = await contract.transfer(toAddress, amount);
console.log('트랜잭션 해시:', tx.hash);

// 트랜잭션 확인 기다리기
const receipt = await tx.wait();
console.log('확인된 블록:', receipt.blockNumber);

// 특정 컨펌 수 기다리기
const receipt2 = await tx.wait(5); // 5개 블록 컨펌 기다리기
console.log('5개 블록 확인 완료!');

8.4 Alchemy와 Infura 관련 FAQ

// ethers.js 사용 예시
const providers = {
    mainnet: new ethers.providers.AlchemyProvider('mainnet', ALCHEMY_KEY),
    polygon: new ethers.providers.AlchemyProvider('matic', ALCHEMY_KEY),
    optimism: new ethers.providers.AlchemyProvider('optimism', ALCHEMY_KEY)
};

// 네트워크별 잔액 조회
async function getBalances(address) {
    const balances = {};
    for (const [network, provider] of Object.entries(providers)) {
        balances[network] = await provider.getBalance(address);
    }
    return balances;
}

개발 과정에서 문제가 발생하면 공식 문서를 확인하고, GitHub 이슈나 Stack Overflow에서 유사한 문제를 검색해보는 것이 좋아. 또한 Discord나 Telegram 같은 커뮤니티 채널에서 도움을 구할 수도 있어! 블록체인 개발은 빠르게 발전하는 분야라 지속적인 학습이 중요해.