Web3를 사용하여 트랜잭션 전송하기

트랜잭션

web3.js

alchemy

초급

엘란 할펀

2020년 11월 4일

20 분 소요

이 문서는 Web3를 사용하여 이더리움 트랜잭션을 전송하는 초보자용 가이드입니다. 이더리움 블록체인에 트랜잭션을 전송하려면 생성, 서명, 브로드캐스트라는 세 가지 주요 단계를 거쳐야 합니다. 이 세 가지 단계를 모두 살펴보며 여러분이 가질 수 있는 궁금증을 해결해 드리겠습니다! 이 튜토리얼에서는 Alchemy (opens in a new tab)를 사용하여 이더리움 체인에 트랜잭션을 전송할 것입니다. 여기에서 무료 Alchemy 계정을 생성 (opens in a new tab)할 수 있습니다.

참고: 이 가이드는 앱의 백엔드에서 트랜잭션에 서명하기 위한 것입니다. 프론트엔드에서 트랜잭션 서명하기를 통합하려면 브라우저 공급자와 Web3 (opens in a new tab) 통합을 확인하세요.

기본 사항

처음 시작하는 대부분의 블록체인 개발자들처럼, 여러분도 트랜잭션을 전송하는 방법(매우 간단해야 할 작업)에 대해 조사하다가 서로 다른 내용을 말하는 수많은 가이드를 접하고 다소 압도되거나 혼란스러웠을 수 있습니다. 만약 그렇다면 걱정하지 마세요. 우리 모두 한때는 그랬으니까요! 그러니 시작하기 전에 몇 가지 사항을 명확히 짚고 넘어가겠습니다.

1. Alchemy는 개인 키를 저장하지 않습니다

이는 Alchemy가 여러분을 대신하여 트랜잭션에 서명하고 전송할 수 없음을 의미합니다. 그 이유는 보안 목적 때문입니다. Alchemy는 절대 개인 키 공유를 요구하지 않으며, 여러분도 호스팅된 노드(또는 그 누구와도)와 개인 키를 공유해서는 안 됩니다.
Alchemy의 핵심 API를 사용하여 블록체인에서 데이터를 읽을 수는 있지만, 데이터를 쓰려면 Alchemy를 통해 트랜잭션을 전송하기 전에 다른 도구를 사용하여 트랜잭션에 서명해야 합니다(이는 다른 모든 노드 서비스에서도 마찬가지입니다).

2. "서명자(signer)"란 무엇인가요?

서명자는 개인 키를 사용하여 여러분을 대신해 트랜잭션에 서명합니다. 이 튜토리얼에서는 Alchemy Web3 (opens in a new tab)를 사용하여 트랜잭션에 서명하지만, 다른 Web3 라이브러리를 사용할 수도 있습니다.
프론트엔드에서 서명자의 좋은 예로는 여러분을 대신해 트랜잭션에 서명하고 전송하는 메타마스크 (opens in a new tab)가 있습니다.

3. 왜 트랜잭션에 서명해야 하나요?

이더리움 네트워크에서 트랜잭션을 전송하려는 모든 사용자는 트랜잭션의 출처가 본인임을 검증하기 위해 (개인 키를 사용하여) 트랜잭션에 서명해야 합니다.
개인 키에 접근하면 이더리움 계정에 대한 모든 권한을 얻게 되어 여러분(또는 접근 권한이 있는 누구나)을 대신해 트랜잭션을 수행할 수 있으므로, 이 개인 키를 보호하는 것은 매우 중요합니다.

4. 개인 키는 어떻게 보호하나요?

개인 키를 보호하고 이를 사용해 트랜잭션을 전송하는 방법에는 여러 가지가 있습니다. 이 튜토리얼에서는 .env 파일을 사용할 것입니다. 하지만 개인 키를 저장하는 별도의 공급자를 사용하거나, 키스토어 파일을 사용하는 등 다른 옵션을 선택할 수도 있습니다.

5. `eth_sendTransaction`와 `eth_sendRawTransaction`의 차이점은 무엇인가요?

eth_sendTransaction와 eth_sendRawTransaction는 모두 트랜잭션을 이더리움 네트워크에 브로드캐스트하여 향후 블록에 추가되도록 하는 이더리움 API 함수입니다. 두 함수는 트랜잭션 서명하기를 처리하는 방식에서 차이가 있습니다.

eth_sendTransaction (opens in a new tab)는 서명되지 않은 트랜잭션을 전송하는 데 사용됩니다. 즉, 트랜잭션을 전송받는 노드가 체인에 브로드캐스트하기 전에 트랜잭션에 서명할 수 있도록 여러분의 개인 키를 관리해야 합니다. Alchemy는 사용자의 개인 키를 보관하지 않으므로 이 메서드를 지원하지 않습니다.
eth_sendRawTransaction (opens in a new tab)는 이미 서명된 트랜잭션을 브로드캐스트하는 데 사용됩니다. 즉, 먼저 signTransaction(tx, private_key) (opens in a new tab)를 사용한 다음, 그 결과를 eth_sendRawTransaction에 전달해야 합니다.

Web3를 사용할 때 eth_sendRawTransaction는 web3.eth.sendSignedTransaction (opens in a new tab) 함수를 호출하여 접근합니다.

이 튜토리얼에서는 이 함수를 사용할 것입니다.

6. Web3 라이브러리란 무엇인가요?

Web3.js는 이더리움 개발에서 매우 흔하게 사용되는 표준 JSON-RPC 호출을 감싸는 래퍼(wrapper) 라이브러리입니다.
다양한 언어를 위한 여러 Web3 라이브러리가 있습니다. 이 튜토리얼에서는 JavaScript로 작성된 Alchemy Web3 (opens in a new tab)를 사용할 것입니다. Ethers.js (opens in a new tab)와 같은 다른 옵션은 여기 (opens in a new tab)에서 확인할 수 있습니다.

좋습니다. 이제 몇 가지 궁금증을 해결했으니 튜토리얼로 넘어가 보겠습니다. 언제든지 Alchemy 디스코드 (opens in a new tab)에서 자유롭게 질문해 주세요!

7. 안전하고 가스가 최적화된 비공개 트랜잭션을 전송하는 방법은 무엇인가요?

Alchemy는 다양한 Transact API 제품군을 제공합니다 (opens in a new tab). 이를 사용하여 강화된 트랜잭션을 전송하고, 실행 전에 트랜잭션을 시뮬레이션하며, 비공개 트랜잭션을 전송하고, 가스가 최적화된 트랜잭션을 전송할 수 있습니다.
또한 Notify API (opens in a new tab)를 사용하면 트랜잭션이 멤풀에서 빠져나와 체인에 추가될 때 알림을 받을 수 있습니다.

참고: 이 가이드를 따라 하려면 Alchemy 계정, 이더리움 주소 또는 메타마스크 지갑, NodeJs, 그리고 npm이 설치되어 있어야 합니다. 그렇지 않다면 다음 단계를 따르세요.

무료 Alchemy 계정 생성하기 (opens in a new tab)
메타마스크 계정 생성하기 (opens in a new tab) (또는 이더리움 주소 얻기)
다음 단계에 따라 NodeJs 및 NPM 설치하기 (opens in a new tab)

트랜잭션 전송 단계

1. Sepolia 테스트넷에서 Alchemy 앱 생성하기

Alchemy 대시보드 (opens in a new tab)로 이동하여 새 앱을 생성하고, 네트워크로 Sepolia(또는 다른 테스트넷)를 선택합니다.

2. Sepolia 퍼싯에서 ETH 요청하기

Alchemy Sepolia 퍼싯 (opens in a new tab)의 지침에 따라 ETH를 받으세요. 다른 네트워크가 아닌 (메타마스크의) Sepolia 이더리움 주소를 입력해야 합니다. 지침을 따른 후 지갑에 ETH가 들어왔는지 다시 한번 확인하세요.

3. 새 프로젝트 디렉터리를 생성하고 해당 디렉터리로 `cd` 하기

명령줄(Mac의 경우 터미널)에서 새 프로젝트 디렉터리를 생성하고 해당 디렉터리로 이동합니다.

mkdir sendtx-example
cd sendtx-example

4. Alchemy Web3(또는 다른 Web3 라이브러리) 설치하기

프로젝트 디렉터리에서 다음 명령을 실행하여 Alchemy Web3 (opens in a new tab)를 설치합니다.

참고로 Ethers.js 라이브러리를 사용하려면 여기의 지침을 따르세요 (opens in a new tab).

npm install @alch/alchemy-web3

5. dotenv 설치하기

API 키와 개인 키를 안전하게 저장하기 위해 .env 파일을 사용할 것입니다.

npm install dotenv --save

6. `.env` 파일 생성하기

프로젝트 디렉터리에 .env 파일을 생성하고 다음 내용을 추가합니다("your-api-url" 및 "your-private-key"를 대체하세요).

Alchemy API URL을 찾으려면 대시보드에서 방금 생성한 앱의 세부 정보 페이지로 이동하여 오른쪽 상단의 "View Key"를 클릭하고 HTTP URL을 복사합니다.
메타마스크를 사용하여 개인 키를 찾는 방법은 이 가이드 (opens in a new tab)를 확인하세요.

API_URL = "your-api-url"
PRIVATE_KEY = "your-private-key"

.env 파일을 커밋하지 마세요! .env 파일을 다른 사람과 공유하거나 노출하면 비밀 정보가 유출될 수 있으므로 절대 공유하지 않도록 주의하세요. 버전 관리를 사용하는 경우 .env를 gitignore 파일에 추가하세요.

7. `sendTx.js` 파일 생성하기

좋습니다. 이제 민감한 데이터를 .env 파일에 안전하게 보호했으니 코딩을 시작해 보겠습니다. 트랜잭션 전송 예제에서는 Sepolia 퍼싯으로 ETH를 다시 전송해 보겠습니다.

예제 트랜잭션을 구성하고 전송할 sendTx.js 파일을 생성하고 다음 코드 줄을 추가합니다.

async function main() {
    require('dotenv').config();
    const { API_URL, PRIVATE_KEY } = process.env;
    const { createAlchemyWeb3 } = require("@alch/alchemy-web3");
    const web3 = createAlchemyWeb3(API_URL);
    const myAddress = '0x610Ae88399fc1687FA7530Aac28eC2539c7d6d63' //TODO: 이 주소를 자신의 공개 주소로 바꾸세요

    const nonce = await web3.eth.getTransactionCount(myAddress, 'latest'); // 논스는 0부터 계산을 시작합니다

    const transaction = {
     'to': '0x31B98D14007bDEe637298086988A0bBd31184523', // ETH를 반환할 퍼싯 주소
     'value': 1000000000000000000, // 1 ETH
     'gas': 30000,
     'nonce': nonce,
     // 메시지를 보내거나 스마트 컨트랙트를 실행하기 위한 선택적 데이터 필드
    };

    const signedTx = await web3.eth.accounts.signTransaction(transaction, PRIVATE_KEY);

    web3.eth.sendSignedTransaction(signedTx.rawTransaction, function(error, hash) {
    if (!error) {
      console.log("🎉 트랜잭션 해시는 다음과 같습니다: ", hash, "\n Alchemy의 멤풀을 확인하여 트랜잭션 상태를 확인하세요!");
    } else {
      console.log("❗트랜잭션을 제출하는 동안 문제가 발생했습니다:", error)
    }
   });
}

main();

6번째 줄의 주소를 자신의 공개 주소로 반드시 변경하세요.

이제 이 코드를 실행하기 전에 여기에 포함된 몇 가지 구성 요소에 대해 이야기해 보겠습니다.

nonce : 논스 사양은 주소에서 전송된 트랜잭션 수를 추적하는 데 사용됩니다. 보안 목적과 재전송 공격(replay attack) (opens in a new tab)을 방지하기 위해 이것이 필요합니다. 주소에서 전송된 트랜잭션 수를 가져오기 위해 getTransactionCount (opens in a new tab)를 사용합니다.
transaction: 트랜잭션 객체에는 지정해야 할 몇 가지 요소가 있습니다.
- to: ETH를 전송할 주소입니다. 이 경우 처음에 요청했던 Sepolia 퍼싯 (opens in a new tab)으로 ETH를 다시 전송합니다.
- value: 전송하려는 금액으로, Wei 단위로 지정되며 10^18 Wei = 1 ETH입니다.
- gas: 트랜잭션에 포함할 적절한 가스 양을 결정하는 방법에는 여러 가지가 있습니다. Alchemy는 가스 가격이 특정 임계값 아래로 떨어질 때 알려주는 가스 가격 웹훅 (opens in a new tab)도 제공합니다. 메인넷 트랜잭션의 경우, ETH Gas Station (opens in a new tab)과 같은 가스 추정기를 확인하여 포함할 적절한 가스 양을 결정하는 것이 좋습니다. 21000은 이더리움의 작업이 사용하는 최소 가스 양이므로, 트랜잭션이 확실히 실행되도록 여기에 30000을 입력합니다.
- nonce: 위의 논스 정의를 참조하세요. 논스는 0부터 계산을 시작합니다.
- [선택 사항] data: 전송과 함께 추가 정보를 보내거나 스마트 컨트랙트를 호출하는 데 사용되며, 잔액 전송에는 필요하지 않습니다. 아래의 참고 사항을 확인하세요.
signedTx: 트랜잭션 객체에 서명하기 위해 PRIVATE_KEY와 함께 signTransaction 메서드를 사용합니다.
sendSignedTransaction: 서명된 트랜잭션이 있으면 sendSignedTransaction를 사용하여 후속 블록에 포함되도록 전송할 수 있습니다.

데이터(data)에 대한 참고 사항 이더리움에서 전송할 수 있는 트랜잭션에는 두 가지 주요 유형이 있습니다.

잔액 전송: 한 주소에서 다른 주소로 ETH를 전송합니다. 데이터 필드는 필요하지 않지만, 트랜잭션과 함께 추가 정보를 보내려면 이 필드에 HEX 형식으로 해당 정보를 포함할 수 있습니다.
- 예를 들어, 불변의 타임스탬프를 부여하기 위해 IPFS 문서의 해시를 이더리움 체인에 기록하려고 한다고 가정해 보겠습니다. 이 경우 데이터 필드는 data: web3.utils.toHex(‘IPFS hash‘)와 같아야 합니다. 그러면 누구나 체인을 쿼리하여 해당 문서가 언제 추가되었는지 확인할 수 있습니다.
스마트 컨트랙트 트랜잭션: 체인에서 스마트 컨트랙트 코드를 실행합니다. 이 경우 데이터 필드에는 실행하려는 스마트 함수와 매개변수가 포함되어야 합니다.
- 실제 예제는 이 Hello World 튜토리얼 (opens in a new tab)의 8단계를 확인하세요.

8. `node sendTx.js`를 사용하여 코드 실행하기

터미널이나 명령줄로 돌아가서 다음을 실행합니다.

node sendTx.js

9. 멤풀에서 트랜잭션 확인하기

Alchemy 대시보드에서 멤풀 페이지 (opens in a new tab)를 열고 생성한 앱으로 필터링하여 트랜잭션을 찾습니다. 여기에서 트랜잭션이 대기(pending) 상태에서 채굴(mined) 상태(성공 시) 또는 삭제(dropped) 상태(실패 시)로 전환되는 것을 지켜볼 수 있습니다. "채굴됨", "대기 중", "삭제됨" 트랜잭션을 모두 포착할 수 있도록 "All"로 유지하세요. 주소 0x31b98d14007bdee637298086988a0bbd31184523로 전송된 트랜잭션을 검색하여 트랜잭션을 찾을 수도 있습니다.

트랜잭션을 찾은 후 세부 정보를 보려면 트랜잭션 해시를 선택하세요. 그러면 다음과 같은 화면으로 이동합니다.

거기에서 빨간색 동그라미로 표시된 아이콘을 클릭하면 Etherscan에서 트랜잭션을 볼 수 있습니다!

야호! 방금 Alchemy를 사용하여 첫 번째 이더리움 트랜잭션을 전송했습니다 🎉

이 가이드에 대한 피드백이나 제안 사항이 있다면 Alchemy의 디스코드 (opens in a new tab)에서 엘란(Elan)에게 메시지를 보내주세요!

원본 게시물: https://docs.alchemyapi.io/tutorials/sending-transactions-using-web3-and-alchemy (opens in a new tab)