The quickest way to start building on XRPL 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 other popular programming languages.
Get Your XRPL Endpoint
Criar uma conta no Quicknode
Inscreve-te aqui, se ainda não o fizeste.
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
Criar um novo ponto de extremidade
Click Create an Endpoint in the top-right corner, select XRPL as your blockchain, then select your preferred network
Copie os URLs do seu fornecedor
Tenha a URL HTTP à mão. Vai precisar dela nas solicitações que vai fazer a seguir.
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 XRPL blockchain. We'll use the fee method, which retrieves current fee information from the network. Select your preferred language and follow the steps below to send your first request.
- cURL
- Node.js
Python- Ruby
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
Enviar um pedido JSON-RPC
In your terminal, copy and paste the following cURL command to retrieve current fee information:
curl YOUR_QUICKNODE_ENDPOINT_URL/ \
-X POST \
-H "Content-Type: application/json" \
--data '{
"method": "fee",
"params": [{}],
"id": 1,
"jsonrpc": "2.0"
}'
Exemplo de resposta
{
"id": 1,
"status": "success",
"type": "response",
"result": {
"current_ledger_size": "56",
"current_queue_size": "0",
"drops": {
"base_fee": "10",
"median_fee": "5000",
"minimum_fee": "10",
"open_ledger_fee": "10"
},
"expected_ledger_size": "55",
"ledger_current_index": 75708765,
"levels": {
"median_level": "128000",
"minimum_level": "256",
"open_ledger_level": "256",
"reference_level": "256"
},
"max_queue_size": "1100"
}
}
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 xrpl-api-quickstart
cd xrpl-api-quickstart
npm init -y
Crie o seu ficheiro principal
Crie um ficheiro index.js para o seu código:
touch index.js
Adicione este código ao seu ficheiro index.js
Copie e cole este código no seu ficheiro index.js:
const https = require('https');
const data = JSON.stringify({
method: "fee",
params: [{}],
id: 1,
jsonrpc: "2.0"
});
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 responseData = '';
res.on('data', (chunk) => {
responseData += chunk;
});
res.on('end', () => {
console.log('XRPL Fee Information:');
console.log(JSON.stringify(JSON.parse(responseData), null, 2));
});
});
req.on('error', (error) => {
console.error('Error:', error);
});
req.write(data);
req.end();
Executar o script
Execute your Node.js script to retrieve fee information:
node index.js
Configure o seu projeto
Create a new directory for your project:
mkdir xrpl-api-quickstart
cd xrpl-api-quickstart
Criar e ativar um ambiente virtual
Criar um ambiente virtual para gerir dependências:
python3 -m venv venv
source venv/bin/activate
Install required packages
Install the requests library:
pip instalar requests
Crie um script em Python (main.py)
Crie um ficheiro main.py com o seguinte código:
import requests
import json
url = "YOUR_QUICKNODE_ENDPOINT_URL/"
payload = {
"method": "fee",
"params": [{}],
"id": 1,
"jsonrpc": "2.0"
}
headers = {
'Content-Type': 'application/json'
}
try:
response = requests.post(url, json=payload, headers=headers)
response.raise_for_status()
data = response.json()
print("XRPL Fee Information:")
print(json.dumps(data, indent=2))
except requests.exceptions.RequestException as e:
print(f"Error making request: {e}")
except json.JSONDecodeError as e:
print(f"Error parsing JSON: {e}")
Executar o script
Execute your Python script to retrieve fee information:
python main.py
Configure o seu projeto
Crie um novo diretório para o seu projeto Ruby:
mkdir xrpl-ruby-quickstart
cd xrpl-ruby-quickstart
Check Ruby Installation
Verifique se o Ruby está instalado no seu sistema. Caso contrário, instale-o a partir de https://ruby-lang.org:
ruby --versão
Criar um script em Ruby (main.rb)
Crie um ficheiro main.rb com o seguinte código:
require 'uri'
require 'net/http'
require 'json'
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 = {
method: "fee",
params: [{}],
id: 1,
jsonrpc: "2.0"
}.to_json
begin
response = https.request(request)
if response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)
puts 'XRPL Fee Information:'
puts JSON.pretty_generate(data)
else
puts "HTTP Error: #{response.code} - #{response.message}"
end
rescue JSON::ParserError => e
puts "JSON parsing error: #{e.message}"
rescue => e
puts "Error: #{e.message}"
end
Executar o script
Execute your Ruby script to retrieve fee information:
ruby main.rb
Se quiseres continuar a aprender sobre como efetuar pedidos à API, consulta os nossos guias e aplicações de exemplo.
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!