The quickest way to start building on Cosmos with Quicknode is by sending a JSON-RPC or REST/gRPC 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 Cosmos 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 Cosmos 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 Cosmos blockchain. We’ll use the block_by_hash method, which returns details of a specificed block when given a hash parameter. Select your preferred language or tool and follow the steps to send your 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

Query block by hash

Retrieve block information by hash from your Quicknode endpoint:

curl --location '<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134'

3

Sample response

{
  "jsonrpc": "2.0",
  "id": -1,
  "result": {
    "block_id": { ... }
    },
    "block": {
      "header": {
        "version": {
          "block": "11"
        },
        "chain_id": "cosmoshub-4",
        "height": "20431644",
        "time": "2024-05-15T01:23:57.786705041Z",
        "last_block_id": { ... },
      },
      "data": {
        "txs": [ ... ]
      },
      "evidence": {
        "evidence": []
      },
      "last_commit": { ... }
    }
  }
}

Node.js

1

Configure o seu projeto

Create a directory and initialize a Node.js project:

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

2

Create app.js

Use native fetch (Node.js 18+):

const requestOptions = { method: 'GET', redirect: 'follow' };
		  
async function main() {
	try {
		const url = '<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134';
		const res = await fetch(url, requestOptions);
		const text = await res.text();
		console.log('Block information:', text);
	} catch (err) {
		console.error('Error:', err);
	}
};
}

main();

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 cosmos-python-quickstart
cd cosmos-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)

Crie um ficheiro Python com o seguinte código:

import requests
		  
url = '<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134'

resp = requests.get(url)
print('Block information:')
print(resp.text)

5

Executar o script

Execute o seu script em Python:

python app.py

Ruby

1

Configure o seu projeto

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

mkdir cosmos-ruby-quickstart
cd cosmos-ruby-quickstart

2

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

3

Criar um script em Ruby (main.rb)

Crie um ficheiro main.rb com o seguinte código:

require 'uri'
require 'net/http'

url = URI('<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134')

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

req = Net::HTTP::Get.new(url)
res = https.request(req)

puts 'Block information:'
puts res.body

4

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.

Visão geral da API

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

Pontos de acesso do prestador

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

Referência de erro

Reference document for common Cosmos RPC error codes and troubleshooting tips

Complementos do Marketplace

Discover powerful add-ons and extensions to enhance your Cosmos 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!