|
| 1 | +# GetBlock의 TON API |
| 2 | + |
| 3 | +이 가이드는 GetBlock을 통해 개인 RPC 엔드포인트를 획득하고 사용하는 필수 단계를 다루며, 이를 통해 TON 블록체인에 접근할 수 있습니다. |
| 4 | + |
| 5 | +:::info |
| 6 | +[GetBlock](https://getblock.io/)은 HTTP 기반 API 엔드포인트를 제공하여 클라이언트가 TON을 포함한 다양한 블록체인 네트워크와 상호작용할 수 있도록 하는 Web3 인프라 제공업체입니다. |
| 7 | +::: |
| 8 | + |
| 9 | +## TON 블록체인 엔드포인트 액세스 방법 |
| 10 | + |
| 11 | +GetBlock의 엔드포인트를 사용하려면, 사용자 계정에 로그인하여 TON 엔드포인트 URL을 받아야 합니다. 자세한 단계는 아래를 참고하세요. |
| 12 | + |
| 13 | +### 1. GetBlock 계정 생성 |
| 14 | + |
| 15 | +GetBlock [웹사이트](https://getblock.io/?utm_source=external\&utm_medium=article\&utm_campaign=ton_docs)를 방문하여 메인 페이지의 "Get Started for Free" 버튼을 찾습니다. 이메일 주소를 사용하거나 MetaMask 지갑을 연결하여 계정에 가입합니다. |
| 16 | + |
| 17 | + |
| 18 | + |
| 19 | +### 2. TON 블록체인을 선택 |
| 20 | + |
| 21 | +로그인 후, 대시보드로 이동됩니다. "My Endpoints" 섹션을 찾은 후 "Protocols" 드롭다운 메뉴에서 "TON"을 선택합니다. |
| 22 | + |
| 23 | +원하는 네트워크와 API 타입(JSON-RPC 또는 JSON-RPC(v2))을 선택합니다. |
| 24 | + |
| 25 | + |
| 26 | + |
| 27 | +### 3. 엔드포인트 URL 생성 |
| 28 | + |
| 29 | +"Get" 버튼을 클릭하여 TON 블록체인 엔드포인트 URL을 생성합니다. |
| 30 | + |
| 31 | +GetBlock API의 모든 엔드포인트는 `https://go.getblock.io/[ACCESS TOKEN]/`과 같은 일관된 구조를 따릅니다. |
| 32 | + |
| 33 | +이 접근 토큰은 각 사용자 또는 애플리케이션에 대한 고유 식별자로 작동하며, 요청을 적절한 엔드포인트로 라우팅하는 데 필요한 정보를 포함하고 있어 민감한 세부 정보를 노출하지 않습니다. 이는 별도의 승인 헤더나 API 키가 필요 없게 합니다. |
| 34 | + |
| 35 | +사용자는 여러 엔드포인트를 생성하고, 토큰이 유출된 경우 교체하거나, 사용하지 않는 엔드포인트를 삭제할 수 있는 유연성을 갖추고 있습니다. |
| 36 | + |
| 37 | + |
| 38 | + |
| 39 | +이제 이러한 URL을 사용하여 TON 블록체인과 상호작용하고, 데이터를 조회하고, 트랜잭션을 전송하며, 인프라 설정 및 유지 관리의 번거로움 없이 분산 애플리케이션을 구축할 수 있습니다. |
| 40 | + |
| 41 | +### 무료 요청 및 사용자 제한 |
| 42 | + |
| 43 | +모든 등록된 GetBlock 사용자는 40,000회의 무료 요청을 받을 수 있으며, 이는 초당 60회의 요청(RPS)으로 제한됩니다. 요청 잔액은 매일 갱신되며, 지원되는 블록체인의 모든 공유 엔드포인트에서 사용할 수 있습니다. |
| 44 | + |
| 45 | +향상된 기능과 성능을 원할 경우, 유료 옵션을 탐색할 수 있으며, 이는 아래에 설명되어 있습니다. |
| 46 | + |
| 47 | +GetBlock.io는 두 가지 유형의 요금제를 제공합니다: 공유 노드와 전용 노드. 클라이언트는 자신의 요구와 예산에 따라 요금제를 선택할 수 있습니다. |
| 48 | + |
| 49 | +### 공유 노드 |
| 50 | + |
| 51 | +- 여러 클라이언트가 동시에 동일한 노드를 사용하는 초기 진입 기회; |
| 52 | +- 초당 요청 수(RPS)가 200으로 증가; |
| 53 | +- 개인 사용 또는 완전한 생산 애플리케이션에 비해 낮은 거래량과 자원 요구 사항을 가진 애플리케이션에 적합; |
| 54 | +- 제한된 예산을 가진 개인 개발자나 소규모 팀에게 더 경제적인 옵션. |
| 55 | + |
| 56 | +공유 노드는 상당한 초기 투자나 약정 없이 TON 블록체인 인프라에 접근할 수 있는 비용 효율적인 솔루션을 제공합니다. |
| 57 | + |
| 58 | +개발자가 애플리케이션을 확장하고 추가 자원을 필요로 할 경우, 구독 요금제를 쉽게 업그레이드하거나 필요에 따라 전용 노드로 전환할 수 있습니다. |
| 59 | + |
| 60 | +### 전용 노드 |
| 61 | + |
| 62 | +- 하나의 노드가 단독으로 한 클라이언트에게만 할당; |
| 63 | + 요청 제한 없음; |
| 64 | +- 아카이브 노드, 다양한 서버 위치 및 사용자 지정 설정에 대한 접근 허용; |
| 65 | +- 프리미엄 수준의 서비스와 지원 보장; |
| 66 | + |
| 67 | +이는 높은 처리량, 빠른 노드 연결 속도, 확장 시 보장된 자원을 필요로 하는 개발자 및 분산 애플리케이션(dApps)을 위한 차세대 솔루션입니다. |
| 68 | + |
| 69 | +## GetBlock의 TON HTTP API 사용 방법 |
| 70 | + |
| 71 | +이 섹션에서는 GetBlock이 제공하는 TON HTTP API의 실용적인 사용법을 다룹니다. 생성된 엔드포인트를 효과적으로 사용하는 방법을 예시를 통해 살펴보겠습니다. |
| 72 | + |
| 73 | +### 일반적인 API 호출의 예 |
| 74 | + |
| 75 | +먼저, curl 명령어를 사용하여 특정 주소의 잔액을 조회하는 ‘/getAddressBalance’ 메서드를 간단히 예로 들어보겠습니다. |
| 76 | + |
| 77 | +``` |
| 78 | +curl --location --request GET 'https://go.getblock.io/<ACCESS-TOKEN>/getAddressBalance?address=EQDXZ2c5LnA12Eum-DlguTmfYkMOvNeFCh4rBD0tgmwjcFI-' \ |
| 79 | +
|
| 80 | +--header 'Content-Type: application/json' |
| 81 | +``` |
| 82 | + |
| 83 | +`ACCESS-TOKEN`을 GetBlock에서 제공한 실제 액세스 토큰으로 교체하세요. |
| 84 | + |
| 85 | +이 명령어는 해당 주소의 잔액을 나노톤(nanotons) 단위로 출력합니다. |
| 86 | + |
| 87 | + |
| 88 | + |
| 89 | +TON 블록체인을 쿼리할 수 있는 다른 방법도 있습니다: |
| 90 | + |
| 91 | +| # | 메서드 | 엔드포인트 | 설명 | |
| 92 | +| - | ---- | ------------------ | ----------------------------------------------------------------------------- | |
| 93 | +| 1 | GET | getAddressState | 지정된 주소의 현재 상태(초기화되지 않음, 활성, 또는 동결)를 반환합니다. | |
| 94 | +| 2 | GET | getMasterchainInfo | 마스터체인의 상태에 대한 정보를 가져옵니다. | |
| 95 | +| 3 | GET | getTokenData | 지정된 TON 계정과 관련된 NFT 또는 Jetton의 세부 정보를 검색합니다. | |
| 96 | +| 4 | GET | packAddress | TON 주소를 원시 형식에서 사람이 읽을 수 있는 형식으로 변환합니다. | |
| 97 | +| 5 | POST | sendBoc | 직렬화된 BOC 파일과 외부 메시지를 블록체인에 전송하여 실행합니다. | |
| 98 | + |
| 99 | +GetBlock의 [문서](https://getblock.io/docs/ton/json-rpc/ton_jsonrpc/)를 참조하여 추가 메서드 목록과 예제 및 종합적인 API 참조를 확인하세요. |
| 100 | + |
| 101 | +### 스마트 컨트랙트 배포 |
| 102 | + |
| 103 | +개발자는 동일한 엔드포인트 URL을 사용하여 TON 블록체인에 컨트랙트를 원활하게 배포할 수 있습니다. |
| 104 | + |
| 105 | +라이브러리는 GetBlock HTTP API 엔드포인트를 통해 네트워크에 연결하기 위해 클라이언트를 초기화합니다. |
| 106 | + |
| 107 | + |
| 108 | + |
| 109 | +이 튜토리얼은 GetBlock의 API를 사용하여 TON 블록체인을 효과적으로 활용하려는 개발자에게 종합적인 가이드를 제공할 것입니다. |
| 110 | + |
| 111 | +웹사이트](https://getblock.io/?utm_source=external&utm_medium=article&utm_campaign=ton_docs)에서 자세한 내용을 확인하거나 라이브 채팅, [텔레그램](https://t.me/GetBlock_Support_Bot) 또는 웹사이트 양식을 통해 겟블록의 지원팀에 문의해 주세요. |
0 commit comments