솔라나 web3.js v3 출시…기존 앱은 비동기 코드 수정해야

김민준 기자 2026.10.20 07:19

솔라나 개발자들이 자바스크립트 SDK web3.js v3를 공개했다. 내부 구조를 솔라나 키트 기반으로 바꾸면서 비동기 처리와 자료형 등 기존 앱의 코드 수정이 필요해졌다.

토포AI로 이 기사 더 깊이 읽기

코드 편집기 앞에서 비동기 코드를 작성하는 손길 / TokenPost.ai

솔라나(SOL) 개발자들이 자바스크립트 SDK web3.js v3를 공개했다. 기존 클래스형 인터페이스를 유지하면서 내부 구조를 솔라나 키트 기반으로 바꿨고, 비동기 처리와 자료형 변경에 따라 기존 앱은 코드를 손봐야 한다.

솔라나 개발자 계정(@solana_devs)은 10월 6일 자바스크립트 SDK web3.js v3 출시를 알렸다. v3는 기존 클래스를 솔라나 키트 기반으로 다시 구현했다. 클래스 이름은 유지했지만 내부 구현과 일부 동작 방식은 달라졌다.

가장 큰 변화는 동기 메서드가 비동기로 바뀐 점이다. 이전에는 호출 직후 결과를 받던 Keypair.generate() 같은 메서드도 이제 결과를 기다리도록 코드를 수정해야 한다. 숫자 값은 자바스크립트의 큰 정수 자료형인 bigint로, 계정 데이터는 바이트 배열 형식인 Uint8Array로 다룬다.

솔라나 키트는 RPC 요청, 트랜잭션, 서명자, 코덱 등을 조합해 앱을 만드는 도구 모음이다. v3는 기존 클래스형 API를 사용하는 개발자가 이 기반과 연결할 수 있도록 내부 구조를 재구성했다.

기존 버전과의 호환성은 제한적이다. web3.js v1은 유지보수 전용 상태로 넘어갔다. 기존 코드를 v3로 옮기려는 팀은 비동기 처리와 bigint, Uint8Array 변경을 반영해야 한다.

실행 환경은 Node.js 20.18 이상과 최신 브라우저를 지원한다.