The quickest way to start building on Fuel with Quicknode is by sending a GraphQL 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 Fuel Endpoint
Criar uma Quicknode
Inscreve-te aqui, se ainda não o fizeste.
Aceda ao seu painel de controlo
Open the Endpoints dashboard from the left sidebar menu to manage all your blockchain endpoints
Criar um novo endpoint
Click Create an Endpoint in the top-right corner, select Fuel 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 se seguem.
Para um guia detalhado do Quicknode do Quicknode , consulte o nosso guia
Envie o seu primeiro pedido
Your endpoint is ready. Now, let's make your first call to the Fuel blockchain. We'll use the getChainName query, which retrieves the name of the blockchain network. Selecione o seu idioma preferido e siga os passos abaixo para enviar o seu primeiro pedido.
- cURL
- Node.js
Python- TypeScript
- Apollo Client
- Ruby
Verificar a instalação do cURL
Most *nix based systems have cURL support out of the box. Open your terminal and check the cURL version by running the command below:
curl --versão
Get chain name
Retrieve the chain name using the getChainName query:
curl --location 'YOUR_QUICKNODE_ENDPOINT_URL/v1/graphql' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"query": "{ chain { name } }"}'
Configure o seu projeto
Crie um diretório e inicialize um projeto Node.js:
mkdir fuel-js-quickstart
cd fuel-js-quickstart
npm init -y
Criar o ficheiro app.js
Create a file named app.js to call the getChainName query:
const https = require('https');
const data = JSON.stringify({
"query": "{ chain { name } }"
});
const options = {
hostname: '{your-endpoint-name}.quiknode.pro',
path: '/{your-token}/v1/graphql',
method: 'POST',
headers: {
'Accept': 'application/json',
'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('Chain name:', result);
});
});
req.on('error', (error) => {
console.error('Error:', error);
});
req.write(data);
req.end();
Correr
Execute o seu script:
node app.js
Configure o seu projeto
Crie um novo diretório para o seu projeto em Python:
mkdir fuel-python-quickstart
cd fuel-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)
Create a Python file to call the getChainName query:
import requests
import json
url = "YOUR_QUICKNODE_ENDPOINT_URL/v1/graphql"
payload = json.dumps({
"query": "{ chain { name } }"
})
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print('Chain name:')
print(response.text)
Correr
Execute o seu script:
python app.py
Configure o seu projeto
Crie um diretório e inicialize um projeto TypeScript:
mkdir fuel-ts-quickstart
cd fuel-ts-quickstart
npm init -y
npm install typescript @types/node tsx
npx tsc --init
Criar o ficheiro app.ts
Create a file named app.ts to call the getChainName query:
import https from 'https';
interface GraphQLResponse {
data: {
chain: {
name: string;
};
};
}
const data = JSON.stringify({
query: "{ chain { name } }"
});
const options: https.RequestOptions = {
hostname: '{your-endpoint-name}.quiknode.pro',
path: '/{your-token}/v1/graphql',
method: 'POST',
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json',
'Content-Length': data.length
}
};
const req = https.request(options, (res) => {
let result = '';
res.on('data', (chunk: Buffer) => {
result += chunk.toString();
});
res.on('end', () => {
const response: GraphQLResponse = JSON.parse(result);
console.log('Chain name:', response.data.chain.name);
});
});
req.on('error', (error: Error) => {
console.error('Error:', error);
});
req.write(data);
req.end();
Correr
Execute o seu script:
npx tsx app.ts
Configure o seu projeto
Create a directory and install Apollo Client:
mkdir fuel-apollo-quickstart
cd fuel-apollo-quickstart
npm init -y
npm install @apollo/client graphql cross-fetch
Criar o ficheiro app.js
Create a file named app.js to query using Apollo Client:
const { ApolloClient, InMemoryCache, gql, HttpLink } = require('@apollo/client');
const fetch = require('cross-fetch');
const client = new ApolloClient({
link: new HttpLink({
uri: 'YOUR_QUICKNODE_ENDPOINT_URL/v1/graphql',
fetch,
}),
cache: new InMemoryCache(),
});
const GET_CHAIN_NAME = gql`
query GetChainName {
chain {
nome
}
}
`;
client
.query({
query: GET_CHAIN_NAME,
})
.then((result) => {
console.log('Chain name:', result.data.chain.name);
})
.catch((error) => {
console.error('Error:', error);
});
Correr
Execute o seu script:
node app.js
Configure o seu projeto
Crie um novo diretório para o seu projeto Ruby:
mkdir fuel-ruby-quickstart
cd fuel-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 (app.rb)
Create an app.rb file to call the getChainName query:
require "uri"
require "json"
require "net/http"
url = URI("YOUR_QUICKNODE_ENDPOINT_URL/v1/graphql")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"query": "{ chain { name } }"
})
response = https.request(request)
result = JSON.parse(response.read_body)
puts "Chain name:"
puts result["data"]["chain"]["name"]
Executar o script
Execute o seu script Ruby:
ruby app.rb
If you want to continue learning about making API requests, check out our guides and sample apps.