프로젝트 소개

# fuels-ts **fuels-ts**는 Sway 언어와 FuelVM 기반의 모듈형 블록체인인 **Fuel Network**를 위한 공식 TypeScript SDK입니다. 개발자에게 탈중앙화 애플리케이션(dApp) 구축, 네트워크 상호작용, 스마트 컨트랙트 관리를 위한 포괄적인 툴킷을 제공합니다. ## 주요 기능 - **프로바이더 연결**: GraphQL 엔드포인트를 통해 Fuel 메인넷, 테스트넷 또는 로컬 노드에 연결합니다. 체인 ID, 가스 구성, 기본 자산 ID를 조회합니다. - **dApp 스캐폴딩**: `npm create fuels`를 사용하여 풀스택 Fuel dApp 템플릿을 빠르게 생성합니다. - **CLI 도구**: `fuels` CLI는 구성 초기화, Sway 프로그램 빌드, TypeScript 타입 생성, 컨트랙트 배포, 핫 리로드가 가능한 로컬 노드 실행 명령을 제공합니다. - **TypeScript 생성**: Sway ABI JSON 파일에서 TypeScript 바인딩을 자동으로 생성하여 타입 안전한 컨트랙트 상호작용을 보장합니다. - **지갑 통합**: 서명 및 트랜잭션 관리를 위해 Fuel Wallet SDK와 함께 작동합니다. ## 설치 ```console npm install fuels --save ``` ## 빠른 시작 네트워크에 연결하고 기본 정보를 가져옵니다: ```ts import { Provider } from 'fuels'; const NETWORK_URL = 'https://mainnet.fuel.network/v1/graphql'; const provider = new Provider(NETWORK_URL); const chainId = await provider.getChainId(); const gasConfig = await provider.getGasConfig(); const baseAssetId = await provider.getBaseAssetId(); console.log({ chainId, gasConfig, baseAssetId }); ``` ## CLI 명령어 - `fuels init` – `fuel.config.ts` 파일을 생성합니다. - `fuels build` – Sway 워크스페이스를 빌드하고 TypeScript 타입을 생성합니다. - `fuels deploy` – 컨트랙트를 배포하고 ID를 JSON에 저장합니다. - `fuels dev` – 핫 리로드가 가능한 로컬 노드를 시작합니다. - `fuels node` – 프로젝트 구성을 사용하여 노드를 시작합니다. - `fuels typegen` – ABI JSON에서 TypeScript를 생성합니다. - `fuels versions` – 버전 호환성을 확인합니다. ## 문서 및 리소스 - [TypeScript SDK 문서](https://docs.fuel.network/docs/fuels-ts) - [Fuel 툴체인 설치](https://docs.fuel.network/guides/installation/) - [Fuel Wallet SDK](https://docs.fuel.network/docs/wallet) - [Rust SDK](https://docs.fuel.network/docs/fuels-rs) - [Sway 언어](https://docs.fuel.network/docs/sway) - [Fuel Core](https://github.com/FuelLabs/fuel-core) ## 생태계 - Fuel Bridge: https://app.fuel.network/bridge - 블록 탐색기: https://app.fuel.network - 생태계 앱: https://app.fuel.network/ecosystem ## 커뮤니티 - 포럼: https://forum.fuel.network - Discord: https://discord.gg/xfpK4Pe ## 라이선스 Apache 2.0. [LICENSE](https://github.com/FuelLabs/fuels-ts/blob/master/LICENSE)를 참조하세요.