Sorgulamalar / İstemciler

Umee'de sorguların nasıl gerçekleştirileceğine genel bakış

Umee ağı içinde sorgu gerçekleştirmenin CLI, Tendermint'in RPC'si ve uygulamanın gRPC ve API örneklerini kullanma gibi birden çok yolu vardır. Bu kılavuzun tüm olası sorgulara ve bunların nasıl çağrılacağına ilişkin kapsamlı bir genel bakış olmadığını unutmayın.

CLI ( Komut Satır Arayüzü )

Tüm Cosmos SDK tabanlı uygulamalar gibi, operatörler de çalışan bir umeed işlemine karşı sorgular başlatabilir. Kural olarak, sorgular bir modül alt komutu altında gerçekleştirilir.

Örneğin, bir hesabın bakiyesini sorgulamak için:

$ umeed q bank balances umee17lu4h5nh28ctv9y6ldt0apqz7dxm8arvttx5xc
balances:
- amount: "5500000000000"
  denom: uumee
pagination:
  next_key: null
  total: "0"

Varsayılan olarak, umeed işlemi localhost'a karşı sorgu yapacaktır. Harici bir düğüme karşı sorgulama yapmak istiyorsanız, --node komutunu eklemelisiniz.

--chain-id ve --node gibi aynı bayrakları tekrar tekrar sağlamak zorunda kalmamak için, config dizininde bir client.toml dosyasını bu değerlerle doldurabilirsiniz. Örneğin:

$HOME/.umee/confing/client.toml

chain-id = "<chain-id>"
output = "text"
broadcast-mode = "sync"

Tüm modüller ve sorgu komutları için $ umeed --help bölümüne bakın.

API ve gRPC

Bu özellik etkinleştirilirse, umeed node, bir gRPC ve gRPC Gateway API'sini kullanıma sunabilir. Varsayılan olarak, gRPC sunucusu 9090 numaralı bağlantı noktasında çalışır ve gRPC Ağ Geçidi API sunucusu 1317 numaralı bağlantı noktasında çalışır - bu bağlantı noktalarının her ikisi de app.toml'de yapılandırılabilir.

Örneğin, bir hesabın bakiyesini sorgulamak için:

$ curl http://localhost:1317/cosmos/bank/v1beta1/balances/umee17lu4h5nh28ctv9y6ldt0apqz7dxm8arvttx5xc
{
  "balances": [
    {
      "denom": "uumee",
      "amount": "5500000000000"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "1"
  }
}

Kullanımdan kaldırılan eski yollar yerine gRPC Ağ Geçidi API yollarını kullanmanızı öneririz. Kullanımdan kaldırılan eski API yolları, gelecekteki bir Cosmos SDK sürümünde tamamen kaldırılacaktır. Tüm gRPC Gateway API yolları, Protobuf sürümünü içerir, ör. v1beta1.

Varsayılan olarak, gRPC Gateway API, geçerli blok yüksekliğine göre durumu sorgular. Ayrıca, x-cosmos-block-height başlığı aracılığıyla önceki yüksekliklerdeki sorguları da destekler:

$ curl -H "x-cosmos-block-height: 400" http://localhost:1317/cosmos/bank/v1beta1/balances/umee17lu4h5nh28ctv9y6ldt0apqz7dxm8arvttx5xc
{
  "balances": [
    {
      "denom": "uumee",
      "amount": "350000000011"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "1"
  }
}

Ayrıca, gRPC sunucusuna karşı doğrudan gRPC sorgularını da çağırabilirsiniz. grpcurl aracını kullanmanızı öneririz.

Örneğin, bir hesabın bakiyesini sorgulamak için:

$ grpcurl -d '{"address": "umee17lu4h5nh28ctv9y6ldt0apqz7dxm8arvttx5xc"}' --plaintext 0.0.0.0:9090 cosmos.bank.v1beta1.Query/AllBalances
{
  "balances": [
    {
      "denom": "uumee",
      "amount": "5500000000000"
    }
  ],
  "pagination": {
    "total": "1"
  }
}