The quickest way to start building on Katana with Quicknode is by sending a JSON-RPC request to your endpoint. In this quickstart, you’ll create an endpoint, copy its provider URL, and make your first request. Code samples are available in cURL as well as popular SDKs and programming languages.

Get Your Katana Endpoint

1

Quicknode 만들기

아직 가입하지 않으셨다면 여기에서 가입해 주세요.

2

대시보드로 이동하세요

왼쪽 사이드바 메뉴에서 ‘엔드포인트’ 대시보드를 열어 모든 블록체인 엔드포인트를 관리하세요

3

새 endpoint 생성

Click Create an Endpoint in the top-right corner, select Katana as your blockchain, then select your preferred network

4

서비스 제공업체 URL을 복사하세요

HTTP URL을 잘 챙겨 두세요. 아래에서 요청을 보낼 때 이 URL을 사용하게 될 것입니다.

대시보드에 대해 자세히 알아보기

Quicknode 대한 자세한 사용 방법은 당사의 가이드를 확인해 주세요

첫 요청 보내기

Your endpoint is ready. Now, let's make your first call to the Katana blockchain. We’ll use the eth_blockNumber 최신 블록 번호를 반환하는 메서드입니다. 원하는 언어 또는 SDK 선택하고 SDK 아래 단계를 따라 첫 번째 요청을 보내보세요..

cURL

1

cURL 설치 상태 확인

대부분의 *nix 기반 시스템은 기본적으로 cURL을 지원합니다. 터미널을 열고 아래 명령어를 실행하여 cURL 버전을 확인하세요:

curl --version

2

JSON-RPC 요청 보내기

터미널에서 다음 cURL 명령어를 복사하여 붙여넣어 최신 블록 번호를 조회하세요:

curl -X POST YOUR_QUICKNODE_ENDPOINT_URL/ \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

3

답변 예시

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1234567"
}

SDK

1

프로젝트 설정하기

먼저, `node --version` 명령어를 실행하여 Node.js가 설치되어 있는지 확인하세요. 설치되어 있지 않다면 https://nodejs.org에서 다운로드하세요. 그런 다음 새 디렉터리를 생성하고 Node.js 프로젝트를 초기화하세요:

mkdir katana-api-quickstart
cd katana-api-quickstart
npm init -y

2

SDK 설치하기

SDK 설치하십시오:

npm 설치sdk

3

메인 파일 만들기

코드를 담을 index.js 파일을 생성하세요:

touch index.js

4

이 코드를 index.js 파일에 추가하세요

이 코드를 복사하여 index.js 파일에 붙여넣으세요:

const { Core } = require('@quicknode/sdk');

const main = async () => {
  const core = new Core({
    endpointUrl: 'YOUR_QUICKNODE_ENDPOINT_URL/',
  });

  const blockNumber = await core.client.request({
    method: 'eth_blockNumber',
  });

  console.log('Block number:', parseInt(blockNumber, 16));
};

main();

5

프로젝트 실행하기

스크립트를 실행하여 최신 블록 번호를 확인하세요:

node index.js

파이썬

1

프로젝트 설정하기

Python 프로젝트를 위한 새 디렉터리를 생성하세요:

mkdir katana-python-quickstart
cd katana-python-quickstart

2

가상 환경 생성 및 활성화

의존성을 관리하기 위한 가상 환경을 생성합니다:

python3 -m venv venv
출처 venv/bin/activate

3

설치 요청

HTTP 요청을 보내기 위해 requests 라이브러리를 설치하세요:

pip 설치 requests

4

파이썬 스크립트(app.py)를 만듭니다.

다음 코드가 포함된 Python 파일을 생성하세요:

import requests
import json

# Your Quicknode endpoint URL
endpoint_url = "YOUR_QUICKNODE_ENDPOINT_URL/"

# JSON-RPC request payload
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_blockNumber",
    "params": []
}

# Make the request
response = requests.post(endpoint_url, json=payload)
result = response.json()

print("Latest block number (hex):", result["result"])
print("Latest block number (decimal):", int(result["result"], 16))

5

스크립트를 실행하세요

파이썬 스크립트를 실행하세요:

python app.py

자바스크립트

1

프로젝트 설정하기

새 디렉터리를 만들고 Node.js 프로젝트를 초기화합니다:

mkdir katana-js-quickstart
cd katana-js-quickstart
npm init -y

2

자바스크립트 파일(app.js)을 생성합니다.

다음 코드가 포함된 app.js 파일을 생성하세요(Node.js 18 이상에서 사용할 수 있는 네이티브 fetch를 사용).

const url = 'YOUR_QUICKNODE_ENDPOINT_URL/';
const options = {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'eth_blockNumber',
    params: [],
    id: 1
  })
};

async function main() {
  try {
    const response = await fetch(url, options);
    const data = await response.json();
    console.log('Block Number (hex):', data.result);
    console.log('Block Number (decimal):', parseInt(data.result, 16));
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

3

스크립트를 실행하세요

자바스크립트 스크립트를 실행하세요:

node app.js

루비

1

프로젝트 설정하기

Ruby 프로젝트를 위한 새 디렉터리를 생성하세요:

mkdir katana-ruby-quickstart
cd katana-ruby-quickstart

2

Ruby 설치 상태 확인

시스템에 Ruby가 설치되어 있는지 확인하십시오. 설치되어 있지 않다면, https://ruby-lang.org에서 설치하십시오:

ruby --version

3

Ruby 스크립트(main.rb)를 만듭니다.

다음 코드가 포함된 main.rb 파일을 생성하세요:

require "uri"
require "json"
require "net/http"

url = URI("YOUR_QUICKNODE_ENDPOINT_URL/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "eth_blockNumber",
  "params": [],
  "id": 1,
  "jsonrpc": "2.0"
})

response = https.request(request)
result = JSON.parse(response.read_body)
hex_result = result["result"]
decimal_result = hex_result.to_i(16)
puts "Block number (hex): #{hex_result}"
puts "Block number (decimal): #{decimal_result}"

4

스크립트를 실행하세요

Ruby 스크립트를 실행하여 최신 블록 번호를 확인하세요:

ruby main.rb

가기

1

프로젝트 설정하기

Go 프로젝트를 위한 새 디렉터리를 생성합니다:

mkdir katana-go-quickstart
cd katana-go-quickstart

2

고(Go) 설치 확인

시스템에 Go가 설치되어 있는지 확인하십시오. 설치되어 있지 않다면, https://golang.org에서 설치하십시오:

go version

3

Go 스크립트(main.go) 만들기

다음 코드가 포함된 main.go 파일을 생성하세요:

package main

import (
  "encoding/json"
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
  "strconv"
)

type Response struct {
  Result string `json:"result"`
}

func main() {
  url := "YOUR_QUICKNODE_ENDPOINT_URL/"
  method := "POST"

  payload := strings.NewReader(`{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}`)

  client := &http.Client{}
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    반환
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    반환
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    반환
  }

  var response Response
  err = json.Unmarshal(body, &response)
  if err != nil {
    fmt.Println("Error parsing JSON:", err)
    반환
  }

  // Convert hex to decimal
  blockNumber, err := strconv.ParseInt(response.Result, 0, 64)
  if err != nil {
    fmt.Println("Error converting hex to decimal:", err)
    반환
  }

  fmt.Printf("Block number (hex): %s\n", response.Result)
  fmt.Printf("Block number (decimal): %d\n", blockNumber)
}

4

스크립트를 실행하세요

Go 스크립트를 실행하여 최신 블록 번호를 확인하세요:

main.go를 실행해 보세요

Ethers.js

1

프로젝트 설정하기

새 디렉터리를 만들고 Node.js 프로젝트를 초기화합니다(Node.js가 이미 설치되어 있다고 가정함):

mkdir katana-ethers-quickstart
cd katana-ethers-quickstart
npm init -y
npm pkg set type=module

2

ethers.js 설치하기

Ethereum 위해 ethers.js 라이브러리를 설치하세요:

npm 설치 ethers

3

메인 파일(index.js)을 생성하세요

다음 코드가 포함된 index.js 파일을 생성하세요:

import { ethers } from "ethers";

(async () => {
  const provider = new ethers.JsonRpcProvider("YOUR_QUICKNODE_ENDPOINT_URL/");
  const blockNum = await provider.getBlockNumber();
  console.log('Current block number (decimal):', blockNum);
  console.log('Block number (hex):', '0x' + blockNum.toString(16));
})();

4

프로젝트 실행하기

스크립트를 실행하여 최신 블록 번호를 확인하세요:

node index.js

Web3.py

1

프로젝트 설정하기

web3.py 프로젝트를 위한 새 디렉터리를 생성하세요:

mkdir katana-web3py-quickstart
cd katana-web3py-quickstart

2

web3.py를 설치하세요 (아직 설치되지 않은 경우).

`pip list | grep web3` 명령어를 실행하여 web3.py가 설치되어 있는지 확인하세요. 설치되어 있지 않다면 다음과 같이 설치하세요:

pip 설치 web3

3

파이썬 스크립트(main.py)를 만드세요.

다음 코드가 포함된 main.py 파일을 생성하세요:

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("YOUR_QUICKNODE_ENDPOINT_URL/"))

try:
  latest_block_number = w3.eth.block_number
  print(f"Latest Block Number: {latest_block_number}")
  print(f"Block number (hex): {hex(latest_block_number)}")
except Exception as e:
  print(f"Error: {e}")

Eth.rb

1

프로젝트 설정하기

eth.rb 프로젝트를 위한 새 디렉터리를 생성하세요:

mkdir katana-ethrb-quickstart
cd katana-ethrb-quickstart

2

eth.rb를 설치하십시오(아직 설치되지 않은 경우).

`gem list eth` 명령어를 실행하여 eth.rb가 설치되어 있는지 확인하세요. 설치되어 있지 않다면 다음과 같이 설치하세요:

gem 설치 eth

3

Ruby 스크립트(main.rb)를 만듭니다.

다음 코드가 포함된 main.rb 파일을 생성하세요:

require 'eth'

client = Eth::Client.create "YOUR_QUICKNODE_ENDPOINT_URL/"

begin
  block_number = client.eth_block_number
  hex_result = block_number["result"]
  decimal_result = hex_result.to_i(16)
  puts "Block number (hex): #{hex_result}"
  puts "Block number (decimal): #{decimal_result}"
rescue => e
  puts "Error: #{e.message}"
끝

4

스크립트를 실행하세요

Ruby 스크립트를 실행하여 최신 블록 번호를 확인하세요:

ruby main.rb

Ethgo

1

프로젝트 설정하기

Ethgo 프로젝트를 위한 새 디렉터리를 생성하세요:

mkdir katana-ethgo-quickstart
cd katana-ethgo-quickstart

2

Go 모듈 초기화 및 ethgo 설치

의존성을 추적하기 위해 go.mod 파일을 생성한 다음, ethgo SDK 설치하세요:

go mod init katana-ethgo-quickstart
go get github.com/umbracle/ethgo
go mod tidy

3

Go 스크립트(main.go) 만들기

다음 코드가 포함된 main.go 파일을 생성하세요:

package main

import (
  "fmt"
  "로그"
  "github.com/umbracle/ethgo/jsonrpc"
)

func main() {
  client, err := jsonrpc.NewClient("YOUR_QUICKNODE_ENDPOINT_URL/")
  if err != nil {
    log.Fatalf("Failed to connect to Ethereum: %v", err)
  }

  blockNumber, err := client.Eth().BlockNumber()
  if err != nil {
    log.Fatalf("Failed to get latest block number: %v", err)
  }

  fmt.Printf("Latest block number (decimal): %d\n", blockNumber)
  fmt.Printf("Latest block number (hex): 0x%x\n", blockNumber)
}

4

스크립트를 실행하세요

Go 스크립트를 실행하여 최신 블록 번호를 확인하세요:

main.go를 실행해 보세요

API 개요

Discover Supported Katana APIs, Networks, Chain Configurations, and compatible Quicknode Products

제공자 엔드포인트

Learn how to set up and configure your Katana RPC endpoints for development and production use

Endpoint

토큰 인증, 속도 제한, 화이트리스트, JWT 및 모범 보안 관행을 통해 엔드포인트를 보호하세요

오류 참조

Reference document for common Katana RPC error codes and troubleshooting tips

추가 기능

Discover endpoint add-ons that extend your Katana development workflow