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

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 Fuel 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 Fuel blockchain. We'll use the getChainName query, which retrieves the name of the blockchain network. Select your preferred language and follow the steps below to send your first request.

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

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 } }"}'

Node.js

1

Configure o seu projeto

Create a directory and initialize a Node.js project:

mkdir fuel-js-quickstart
cd fuel-js-quickstart
npm init -y

2

Create 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();

3

Run

Execute your script:

node app.js

Python

1

Configure o seu projeto

Crie um novo diretório para o seu projeto em Python:

mkdir fuel-python-quickstart
cd fuel-python-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

Pedidos de instalação

Instale a biblioteca `requests` para efetuar pedidos HTTP:

pip instalar requests

4

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)

5

Run

Execute your script:

python app.py

TypeScript

1

Configure o seu projeto

Create a directory and initialize a TypeScript project:

mkdir fuel-ts-quickstart
cd fuel-ts-quickstart
npm init -y
npm install typescript @types/node tsx
npx tsc --init

2

Create 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();

3

Run

Execute your script:

npx tsx app.ts

Apollo Client

1

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

2

Create 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 {
      name
    }
  }
`;

client
  .query({
    query: GET_CHAIN_NAME,
  })
  .then((result) => {
    console.log('Chain name:', result.data.chain.name);
  })
  .catch((error) => {
    console.error('Error:', error);
  });

3

Run

Execute your script:

node app.js

Ruby

1

Configure o seu projeto

Crie um novo diretório para o seu projeto Ruby:

mkdir fuel-ruby-quickstart
cd fuel-ruby-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 a Ruby script (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"]

4

Executar o script

Execute your Ruby script:

ruby app.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 Fuel APIs, Networks, Chain Configurations, and compatible Quicknode Products

Pontos de acesso do prestador

Learn how to set up and configure your Fuel 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 Fuel 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!