The quickest way to start building on Zcash 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 Zcash 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 Zcash 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 Zcash blockchain. We'll use the getblock method, which retrieves detailed information about a specific block by its hash. Selecione o seu idioma ou SDK preferido e siga os passos abaixo para enviar o seu primeiro pedido.
- cURL
Python- JavaScript
- 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 block information:
curl YOUR_QUICKNODE_ENDPOINT_URL/ \
-X POST \
-H "Content-Type: application/json" \
--data '{"id": 1, "jsonrpc": "2.0", "method": "getblock", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]}'
Exemplo de resposta
{
"result": {
"hash": "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
"confirmations": 912736,
"size": 216,
"height": 1000,
"version": 1,
"versionHex": "00000001",
"merkleroot": "fe28050b93faea61fa88c4c630f0e1f0a1c24d0082dd0e10d369e13212128f33",
"tx": [
"fe28050b93faea61fa88c4c630f0e1f0a1c24d0082dd0e10d369e13212128f33"
],
"time": 1232346882,
"mediantime": 1232344831,
"nonce": 2595206198,
"bits": "1d00ffff",
"difficulty": 1,
"chainwork": "000000000000000000000000000000000000000000000000000003e903e903e9",
"nTx": 1,
"previousblockhash": "0000000008e647742775a230787d66fdf92c46a48c896bfbc85cdc8acc67e87d",
"nextblockhash": "00000000a2887344f8db859e372e7e4bc26b23b9de340f725afbf2edb265b4c6"
},
"error": null,
"id": 1
}
Configure o seu projeto
Crie um novo diretório para o seu projeto em Python:
mkdir zcash-python-quickstart
cd zcash-python-quickstart
Criar e ativar um ambiente virtual
Criar um ambiente virtual para gerir dependências:
python3 -m venv venv
source venv/bin/activate
Pedidos de instalação
Instale a biblioteca `requests` para efetuar pedidos HTTP:
pip instalar requests
Crie um script em Python (app.py)
Crie um ficheiro Python com o seguinte código:
import requests
import json
# Your Quicknode endpoint URL
url = "YOUR_QUICKNODE_ENDPOINT_URL/"
# JSON-RPC request payload for getblock
payload = json.dumps({
"id": 1,
"jsonrpc": "2.0",
"method": "getblock",
"params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]
})
headers = {
'Content-Type': 'application/json'
}
# Make the request
response = requests.request("POST", url, headers=headers, data=payload)
result = response.json()
print("Block information:")
print(json.dumps(result, indent=2))
Executar o script
Execute o seu script em Python:
python app.py
Configure o seu projeto
Crie um novo diretório e inicialize um projeto Node.js:
mkdir zcash-js-quickstart
cd zcash-js-quickstart
npm init -y
Criar um ficheiro JavaScript (app.js)
Create an app.js file with the following code (using native https module):
const https = require('https');
// Your Quicknode endpoint URL
const data = JSON.stringify({
"id": 1,
"jsonrpc": "2.0",
"method": "getblock",
"params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]
});
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('Block information:');
console.log(JSON.parse(result));
});
});
req.on('error', (error) => {
console.error('Error:', error);
});
req.write(data);
req.end();
Executar o script
Execute o seu script JavaScript:
node app.js
Configure o seu projeto
Crie um novo diretório para o seu projeto Ruby:
mkdir zcash-ruby-quickstart
cd zcash-ruby-quickstart
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
Criar um script em Ruby (main.rb)
Crie um ficheiro main.rb com o seguinte código:
require "uri"
require "json"
require "net/http"
# Your Quicknode endpoint URL
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({
"id": 1,
"jsonrpc": "2.0",
"method": "getblock",
"params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]
})
response = https.request(request)
result = JSON.parse(response.read_body)
puts "Block information:"
puts JSON.pretty_generate(result)
Executar o script
Execute your Ruby script to retrieve block 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!