Quicknode를 사용하여 X Layer에서 개발을 시작하는 가장 빠른 방법은 엔드포인트로 JSON-RPC 요청을 보내는 것입니다. 이 퀵스타트 가이드에서는 엔드포인트를 생성하고, 해당 프로바이더 URL을 복사한 다음, 첫 번째 요청을 보내는 방법을 알아보겠습니다. 코드 예제는 cURL은 물론, 널리 사용되는 SDK 및 프로그래밍 언어로도 제공됩니다.

X Layer 엔드포인트 확인하기

1

Quicknode 계정 만들기

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

2

대시보드로 이동하세요

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

3

새 엔드포인트 생성

오른쪽 상단의 ‘엔드포인트 생성’을 클릭하고, 블록체인으로 ‘X Layer’를 선택한 다음, 원하는 네트워크를 선택하세요.

4

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

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

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

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

첫 요청 보내기

엔드포인트 준비가 완료되었습니다. 이제 X Layer 블록체인에 첫 번째 호출을 해 봅시다. 다음을 사용할 것입니다. eth_blockNumber 최신 블록 번호를 반환하는 메서드입니다. 원하는 언어 또는 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"
}

Quicknode SDK

1

프로젝트 설정하기

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

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

2

Quicknode SDK 설치하기

Quicknode SDK 패키지를 설치합니다:

npm 설치 @quicknode/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 xlayer-python-quickstart
cd xlayer-python-quickstart

2

가상 환경 생성 및 활성화

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

python3 -m venv venv
source 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 xlayer-js-quickstart
cd xlayer-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 xlayer-ruby-quickstart
cd xlayer-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 xlayer-go-quickstart
cd xlayer-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)
    return
  }
  req.Header.Add("Content-Type", "application/json")

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

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

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

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

  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 xlayer-ethers-quickstart
cd xlayer-ethers-quickstart
npm init -y
npm pkg 설정 type=모듈

2

ethers.js 설치하기

이더리움과 연동하기 위해 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 xlayer-web3py-quickstart
cd xlayer-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 xlayer-ethrb-quickstart
cd xlayer-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}"
end

4

스크립트를 실행하세요

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

ruby main.rb

Ethgo

1

프로젝트 설정하기

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

mkdir xlayer-ethgo-quickstart
cd xlayer-ethgo-quickstart

2

Go 모듈 초기화 및 ethgo 설치

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

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

3

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

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

package main

import (
  "fmt"
  "log"
  "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 요청 방법에 대해 더 자세히 알아보고 싶으시다면, 당사의 가이드와 샘플 앱을 확인해 보세요.

API 개요

지원되는 X Layer API, 네트워크, 체인 구성 및 호환 가능한 Quicknode 제품을 확인해 보세요

공급자 엔드포인트

개발 및 운영 환경에서 X Layer RPC 엔드포인트를 설정하고 구성하는 방법을 알아보세요

엔드포인트 보안

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

오류 참조

일반적인 X Layer RPC 오류 코드 및 문제 해결 요령에 대한 참고 문서

마켓플레이스 애드온

X Layer 개발 워크플로우를 향상시켜 줄 강력한 애드온과 확장 기능을 확인해 보세요

여러분의 피드백을 ❤️ 환영합니다!

이 문서에 대한 의견이나 질문이 있으시면 언제든지 알려주세요. 여러분의 의견을 기다리고 있습니다!