The quickest way to start building on NEAR 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, JavaScript, Python, and Ruby.

Get Your NEAR Endpoint

1

Criar uma conta no Quicknode

Inscreve-te aqui, se ainda não o fizeste.

2

Aceda ao seu painel de controlo

Abra o painel «Endpoints» a partir do menu da barra lateral esquerda para gerir todos os seus endpoints de blockchain

3

Criar um novo ponto de extremidade

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

4

Copie os URLs do seu fornecedor

Tenha a URL HTTP à mão. Vai precisar dela nas solicitações que vai fazer a seguir.

Saiba mais sobre o painel de controlo

Para um guia detalhado do painel do Quicknode, consulte o nosso guia

Envie o seu primeiro pedido

Your endpoint is ready. Now, let's make your first call to the NEAR blockchain. We’ll use the estado method, which returns general status information about the NEAR node including version, sync status, and validator information. Selecione o seu idioma ou SDK preferido e siga os passos abaixo para enviar o seu primeiro pedido.

cURL

1

Verificar a instalação do cURL

A maioria dos sistemas baseados em *nix já inclui suporte ao cURL de fábrica. Abra o terminal e verifique a versão do cURL executando o comando abaixo:

curl --versão

2

Enviar um pedido JSON-RPC

In your terminal, copy and paste the following cURL command to retrieve the node status:

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

3

Exemplo de resposta

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "version": {
      "version": "1.37.1",
      "build": "crates-0.21.1-216-gd6385b0eb"
    },
    "chain_id": "mainnet",
    "sync_info": {
      "latest_block_hash": "44L5qF4NitTZgNd5haxFLgWaJJ3FD9VafPo4WdL1p3M8",
      "latest_block_height": 106503813,
      "latest_state_root": "7Bf2aQoAqo1FcYjSddJvPEkrSCsw5j9uEPMBbEE7Kk8",
      "latest_block_time": "2024-01-15T12:00:00.000000000Z",
      "syncing": false
    }
  }
}

Node.js

1

Configure o seu projeto

Primeiro, verifique se o Node.js está instalado com o comando `node --version`. Se não estiver instalado, descarregue-o em https://nodejs.org. Em seguida, crie um novo diretório e inicialize um projeto Node.js:

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

2

Create your script

Create a new file called index.js and add the following code to retrieve the node status:

const https = require('https');

const data = JSON.stringify({
  "jsonrpc": "2.0",
  "method": "status",
  "params": [],
  "id": 1
});

const options = {
  hostname: '{your-endpoint-name}.quiknode.pro',
  path: '/{your-token}/',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length
  }
};

const req = https.request(options, (res) => {
  let result = '';
  res.on('data', (chunk) => {
    result += chunk;
  });
  res.on('end', () => {
    console.log(result);
  });
});

req.on('error', (error) => {
  console.error('Error:', error);
});

req.write(data);
req.end();

3

Run your script

Execute your script in the terminal to retrieve the node status:

node index.js

Python

1

Configure o seu projeto

First, verify Python is installed with python --version or python3 --version. Then create a new directory for your project:

mkdir near-api-quickstart
cd near-api-quickstart

2

Criar e ativar um ambiente virtual

Criar um ambiente virtual para gerir dependências:

python3 -m venv venv
source venv/bin/activate

3

Install dependencies

Instale a biblioteca `requests` para efetuar pedidos HTTP:

pip instalar requests

4

Create your script

Create a new file called main.py and add the following code to retrieve the node status:

import requests
import json

url = "YOUR_QUICKNODE_ENDPOINT_URL/"

payload = json.dumps({
  "jsonrpc": "2.0",
  "method": "status",
  "params": [],
  "id": 1
})

headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

5

Run your script

Execute your script in the terminal to retrieve the node status:

python main.py

Ruby

1

Configure o seu projeto

First, create a new directory for your project:

mkdir near-api-quickstart
cd near-api-quickstart

2

Verificar a instalação do Ruby

Verifique se o Ruby está instalado no seu sistema. Caso contrário, instale-o a partir de https://ruby-lang.org:

ruby --versão

3

Create your script

Create a new file called main.rb and add the following code to retrieve the node status:

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({
  "jsonrpc": "2.0",
  "method": "status",
  "params": [],
  "id": 1
})

response = https.request(request)
puts response.read_body

4

Run your script

Execute your script in the terminal to retrieve the node status:

ruby main.rb

Se quiseres continuar a aprender sobre como efetuar pedidos à API, consulta os nossos guias e aplicações de exemplo.

Visão geral da API

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

Pontos de acesso do prestador

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

Segurança de terminais

Proteja os seus terminais com autenticação por token, limitação de taxa, lista de permissões, JWT e as melhores práticas de segurança

Complementos do Marketplace

Discover powerful add-ons and extensions to enhance your NEAR development workflow

Adoramos ❤️ os vossos comentários!

Se tiver algum comentário ou dúvida sobre esta documentação, não hesite em contactar-nos. Adoraríamos saber a sua opinião!