'Gas'는 트랜잭션 실행이나 스마트 컨트랙트 실행과 같은 작업에 필요한 연산량을 측정하는 단위입니다. 자동차의 연료와 같이, 네트워크가 작업을 처리하고 검증하는 데 반드시 필요합니다. 이더리움의 각 트랜잭션은 복잡도에 따라 일정량의 gas를 필요로 합니다. 사용자는 Gwei(1 Gwei = 이더의 10억분의 1) 단위로 gas 가격을 설정하며, 이는 gas 단위당 지불할 의향이 있는 이더의 양을 나타냅니다.
블록체인 네트워크에서 gas 가격을 이해하는 것은 트랜잭션 비용을 관리하는 데 매우 중요합니다. 현재 gas 가격을 파악하면 트랜잭션을 시작하기에 가장 경제적인 시점을 선택하고 처리 속도를 결정할 수 있습니다. 또한 gas 가격에 대한 인식은 트랜잭션 실패 방지, 예산 계획, 네트워크 혼잡도 파악, 그리고 합리적인 투자 결정을 내리는 데도 필수적입니다.
MetaMask Gas API
Infura를 통해 제공되는 MetaMask Gas API는 이더리움 가상 머신(EVM) 호환 네트워크의 실시간 gas 가격 정보를 제공하기 위해 설계된 전문 도구입니다. 이 API는 오라클로서 기능하며, 해당 네트워크에서 작업이나 트랜잭션을 실행하는 데 필요한 연산 비용에 대한 최신 데이터를 제공합니다. 개발자는 이 API를 활용하여 고급 gas 추정 기능을 구현할 수 있으며, 이를 통해 백엔드 트랜잭션 운영 비용을 절감하거나 사용자 인터페이스를 개선할 수 있습니다.
이 튜토리얼에서는 Gas API, Next.js, ShadcnUI를 사용하여 Gas Tracker 앱을 구축하는 방법을 알아봅니다. 이 애플리케이션을 통해 dapp 사용자는 트랜잭션 우선순위에 맞춘 권장 gas 가격을 확인할 수 있으며, 해당 트랜잭션이 블록체인 블록에 효율적으로 포함될 수 있도록 지원합니다.
사전 요구 사항
유효한 Web3 API 키와 API 키 시크릿.
Node.js 및 npm 또는 yarn 설치.
Next.js와 React에 대한 기본 지식.
Next.js + ShadcnUI 설정
먼저 Node.js가 컴퓨터에 설치되어 있는지 확인하세요. Node.js 설정이 완료되면 터미널을 열고 다음 명령어를 실행하여 새 Next.js 애플리케이션을 시작합니다:
npx create-next-app@latest명령어를 실행하면 여러 프롬프트가 나타나고, 지정한 프로젝트 이름(저는 gastracker-app을 사용했습니다)으로 새 디렉토리가 생성되어 Next.js의 기본 구조가 설정되고 필수 의존성이 설치됩니다. 이제 프로젝트 디렉토리로 이동합니다:
npx create-next-app@latest
✔ What is your project named? … gastracker-app
✔ Would you like to use TypeScript? … No / Yes
✔ Would you like to use ESLint? … No / Yes
✔ Would you like to use Tailwind CSS? … No / Yes
✔ Would you like to use `src/` directory? … No / Yes
✔ Would you like to use App Router? (recommended) … No / Yes
✔ Would you like to customize the default import alias (@/*)? … No / Yes
새 프로젝트 디렉토리로 이동한 후 다음 명령어를 사용하여 개발 모드에서 Next.js 애플리케이션을 실행합니다. 브라우저에서 http://localhost:3000으로 접속하여 애플리케이션을 확인할 수 있습니다.
cd gastracker-app
npm run dev
사용자 인터페이스 구성
애플리케이션에는 컴포넌트 라이브러리를 사용할 것입니다. 먼저 ShadcnUI를 설치합니다:
npx shadcn-ui@latest init설치 중에 다음 프롬프트에 따라 components.json 파일을 구성하게 됩니다:
Would you like to use TypeScript (recommended)? no / yes
Which style would you like to use? › Default
Which color would you like to use as base color? › Slate
Where is your global CSS file? › › app/globals.css
Do you want to use CSS variables for colors? › no / yes
Where is your tailwind.config.js located? › tailwind.config.js
Configure the import alias for components: › @/components
Configure the import alias for utils: › @/lib/utils
Are you using React Server Components? › no / yes
이제 Shadcn UI의 Card 컴포넌트도 설치합니다:
npx shadcn-ui@latest add card이 튜토리얼에서는 Shadcn UI의 Card 컴포넌트를 중점적으로 사용합니다. 이 컴포넌트에 대해 더 알아보려면 Shadcn UI 웹사이트를 방문하세요. 프론트엔드 설정이 완료되었으니 이제 Gas API 작업을 시작할 준비가 되었습니다.
루트 디렉토리에 .env 파일을 생성하고 다음 인증 정보를 저장합니다:
INFURA_API_KEY=
INFURA_API_KEY_SECRET=
API_KEY와 API_KEY_SECRET은 Infura 대시보드에서 가져오세요. API 키를 GitHub에 푸시하지 않도록 주의하세요. 루트 디렉토리의 .gitignore 파일에 필요한 항목이 포함되어 있는지 확인합니다.
# Ignore environment variables
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
axios와 dotenv 패키지도 필요합니다:
npm install axios
npm install dotenv
이제 gastracker-app의 루트에 'index.js' 파일을 생성하고 다음 코드를 복사합니다:
const axios = require("axios");
require("dotenv").config();
const Auth = Buffer.from(
process.env.INFURA_API_KEY + ":" + process.env.INFURA_API_KEY_SECRET,
).toString("base64");
const chainId = 1;
(async () => {
try {
const { data } = await axios.get(
`https://gas.api.infura.io/networks/${chainId}/suggestedGasFees`,
{
headers: {
Authorization: `Basic ${Auth}`,
},
},
);
console.log("Suggested gas fees:", data);
} catch (error) {
console.log("Server responded with:", error);
}
})();
다른 터미널 창에서 다음 명령어를 실행합니다.
node index.js다음과 같은 결과가 표시되어야 합니다:
Suggested gas fees: {
low: {
suggestedMaxPriorityFeePerGas: '0.05',
suggestedMaxFeePerGas: '28.501086221',
minWaitTimeEstimate: 15000,
maxWaitTimeEstimate: 30000
},
medium: {
suggestedMaxPriorityFeePerGas: '0.1',
suggestedMaxFeePerGas: '38.508966399',
minWaitTimeEstimate: 15000,
maxWaitTimeEstimate: 45000
},
high: {
suggestedMaxPriorityFeePerGas: '0.3',
suggestedMaxFeePerGas: '48.666846576',
minWaitTimeEstimate: 15000,
maxWaitTimeEstimate: 60000
},
estimatedBaseFee: '28.451086221',
networkCongestion: 0.7718,
latestPriorityFeeRange: [ '0.05', '9.249760902' ],
historicalPriorityFeeRange: [ '0.023435712', '56.009283908' ],
historicalBaseFeeRange: [ '19.277073248', '31.361941035' ],
priorityFeeTrend: 'down',
baseFeeTrend: 'up'
}
터미널에 데이터가 표시되면 API로부터 응답을 성공적으로 받고 있다는 의미입니다. 다음 단계는 이 데이터를 프론트엔드에 표시하는 것입니다. 이제 index.js 파일을 삭제해도 됩니다.
프론트엔드에 gas 데이터 표시
프로젝트 전반에서 사용할 커스텀 타입을 정의하려면 루트 디렉토리에 'index.d.ts' 파일을 생성하고 다음 내용을 추가합니다:
interface GasFeeEstimate {
suggestedMaxPriorityFeePerGas: string;
suggestedMaxFeePerGas: string;
minWaitTimeEstimate: number;
maxWaitTimeEstimate: number;
}
interface GasFeesApiResponse {
low: GasFeeEstimate;
medium: GasFeeEstimate;
high: GasFeeEstimate;
estimatedBaseFee: string;
networkCongestion: number;
latestPriorityFeeRange: string[];
historicalPriorityFeeRange: string[];
historicalBaseFeeRange: string[];
priorityFeeTrend: 'up' | 'down';
baseFeeTrend: 'up' | 'down';
}
전역 파일에 선언된 이 TypeScript 인터페이스들은 gas 수수료 추정치와 API 응답의 구조를 정의합니다. 블록체인 네트워크의 다양한 트랜잭션 우선순위 수준에 대한 수수료 제안, 대기 시간, 네트워크 혼잡도, 수수료 추세 등의 세부 정보를 포함합니다.
'lib' 폴더에 'getData.ts' 파일을 생성하고 다음 코드를 추가합니다:
const Auth = Buffer.from(
process.env["INFURA_API_KEY"] + ":" + process.env["INFURA_API_KEY_SECRET"]
).toString("base64");
const chainId = 1;
export const getData = async () => {
try {
const res = await fetch(
`https://gas.api.infura.io/networks/${chainId}/suggestedGasFees`,
{
headers: {
Authorization: `Basic ${Auth}`,
},
}
);
const data = await res.json();
return data as GasFeesApiResponse;
} catch (error) {
console.log("Server responded with:", error);
}
};
이 코드는 Gas API에서 gas 수수료 데이터를 가져옵니다:
인증 설정: 환경 변수로 설정된 INFURA_API_KEY와 INFURA_API_KEY_SECRET로 Buffer를 생성합니다. 이 Buffer는 API 요청의 기본 인증을 위해 base64 문자열('Auth'로 명명)로 변환됩니다.
Chain ID 지정: chainId 변수를 1로 설정하며, 이는 일반적으로 블록체인 컨텍스트에서 이더리움 메인넷을 나타냅니다.
getData 함수: gas 수수료 데이터를 가져오기 위한 비동기 함수입니다:
fetch를 사용하여 Infura API 엔드포인트에 GET 요청을 보내 지정된 chainId의 권장 gas 수수료를 가져옵니다.
앞서 생성한 Auth 토큰을 사용하여 요청의 Authorization 헤더를 설정합니다.
성공 시 응답을 JSON으로 파싱하고 이전에 정의한 인터페이스에 맞게 GasFeesApiResponse로 반환합니다.
네트워크 오류나 서버 오류 등의 에러를 콘솔에 기록합니다.
Chain ID 가변성: chainId는 앱이 구축되는 네트워크에 따라 조정할 수 있습니다. Infura의 Gas API는 대부분의 주요 EVM 네트워크를 지원합니다. 지원 네트워크에 대한 자세한 내용은 문서를 참조하세요.
UI 작업
이제 데이터를 표시할 UI에 집중하는 흥미로운 단계에 도달했습니다. components 폴더로 이동하여 'GasCard.tsx'라는 컴포넌트를 생성합니다.
import { getData } from "@/lib/getData";
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
export const GasCard = async () => {
const data = await getData();
const renderGasFeeEstimateCard = (
estimate: GasFeeEstimate,
title: string
) => (
<Card>
<CardHeader>
<CardTitle>{title}</CardTitle>
</CardHeader>
<CardContent>
<p>Max Priority Fee: {estimate.suggestedMaxPriorityFeePerGas}</p>
<p>Max Fee Per Gas: {estimate.suggestedMaxFeePerGas}</p>
<p>Min Wait Time: {estimate.minWaitTimeEstimate} seconds</p>
<p>Max Wait Time: {estimate.maxWaitTimeEstimate} seconds</p>
</CardContent>
</Card>
);
return (
<div className="space-y-4">
<div className="grid grid-cols-1 md:grid-cols-3 gap-4">
{data?.low &&
renderGasFeeEstimateCard(data.low, "Low Gas Fee Estimate")}
{data?.medium &&
renderGasFeeEstimateCard(data.medium, "Medium Gas Fee Estimate")}
{data?.high &&
renderGasFeeEstimateCard(data.high, "High Gas Fee Estimate")}
</div>
<Card>
<CardContent>
<h2 className="font-semibold">Estimated Base Fee</h2>
<p>Gas Price: {data?.estimatedBaseFee}</p>
<h2 className="font-semibold">Network Congestion</h2>
<p>{data?.networkCongestion}</p>
<h2 className="font-semibold">Latest Priority Fee Range</h2>
<p>{data?.latestPriorityFeeRange.join(" - ")}</p>
<h2 className="font-semibold">Historical Priority Fee Range</h2>
<p>{data?.historicalPriorityFeeRange.join(" - ")}</p>
<h2 className="font-semibold">Historical Base Fee Range</h2>
<p>{data?.historicalBaseFeeRange.join(" - ")}</p>
<h2 className="font-semibold">Priority Fee Trend</h2>
<p>{data?.priorityFeeTrend}</p>
<h2 className="font-semibold">Base Fee Trend</h2>
<p>{data?.baseFeeTrend}</p>
</CardContent>
</Card>
</div>
);
};
여기서 일어나는 일을 살펴보겠습니다:
임포트 및 데이터 가져오기:
컴포넌트는 gas 수수료 데이터를 가져오기 위한 getData 함수와 앞서 설치한 Shadcn UI의 Card, CardContent, CardHeader, CardTitle 등 다양한 UI 컴포넌트를 임포트합니다.
GasCard 컴포넌트 내부에서 getData 함수를 호출하여 gas 수수료 데이터를 가져옵니다.
Gas 수수료 추정치 렌더링:
renderGasFeeEstimateCard 함수가 정의되어 있으며, 특정 gas 수수료 추정치(GasFeeEstimate)와 제목(title)에 대한 카드 UI를 렌더링합니다.
이 함수는 최대 우선순위 수수료, gas당 최대 수수료, 예상 대기 시간 등의 세부 정보를 표시하는 Card 컴포넌트를 구성합니다.
컴포넌트 구조:
GasCard 컴포넌트의 JSX 구조는 return 문에 정의되어 있습니다. 그리드 레이아웃을 사용하여 낮음, 보통, 높음 gas 수수료 추정치에 대한 카드를 표시하며, 데이터 가용성에 따라 조건부로 표시됩니다.
추가 카드에는 예상 기본 수수료, 네트워크 혼잡도, 우선순위 수수료 범위(최신 및 과거 데이터), 우선순위 및 기본 수수료 추세 등의 추가 정보가 표시됩니다.
이제 마지막 단계로 GasCard.tsx를 page.tsx 파일에 임포트하면 됩니다. 이후 모든 데이터가 프론트엔드에 표시됩니다.
Gas API 시작하기
Infura의 Gas API를 활용하면 EVM 호환 네트워크를 다루는 개발자에게 상당한 이점을 제공합니다. 변동하는 gas 시장에 대한 실시간 인사이트를 제공하여 사용자가 트랜잭션 수수료에 대해 합리적인 결정을 내릴 수 있도록 합니다. 이는 트랜잭션의 속도와 비용 효율성을 모두 최적화하는 데 특히 유용합니다.
이 튜토리얼에서는 GasAPI를 시작하고 간단한 Gas Tracker 앱을 만드는 방법을 다루었습니다. 코드는 여기에서 확인할 수 있습니다: GitHub의 GasAPI-Template.
하지만 이 외에도 다양한 활용이 가능합니다. 카운트다운과 함께 특정 시간마다 GasData를 새로 고침하는 기능을 추가하거나, GasAPI를 기존 애플리케이션에 통합할 수도 있습니다. 다음 리소스를 참고하시기 바랍니다:
Gas API 문서: Infura Gas API 문서
EventSea: GasAPI를 창의적으로 활용한 풀스택 이벤트 Dapp: GitHub의 EventSea
즐거운 개발 되세요! 🚀