Skip to main content

Introduction

In the following sections, we’ll walk you through the steps needed to integrate the Euclid layer to your project using the Euclid API. You’ll learn how to perform tasks such as:

  • Querying data
  • Executing transactions
  • Managing assets and balances

Each guide includes examples, code snippets, and explanations to ensure you can get up and running quickly.

tip

Prerequisites​

Wallet Connection​

As of now, Euclid supports Keplr and Leap wallets. Please refer to their docs to learn how to integrate these wallets into your application:

Using GQL Queries​

You will need to know how to call a GQL query. If unfamiliar with the process, you can find examples here.

Fetching a Chain Config​

It’s essential to have a solid understanding of how to interact with blockchain configurations. One of the recurring tasks you’ll need to accomplish is Fetching a Chain Config. This is a critical step because the chain config provides all the necessary information required to interact with a specific blockchain network, such as its RPC endpoints.

Fetching the chain config is a three step process:

  1. Retrieving All Chain UIDs: This step allows you to gather all available chain unique identifiers (UIDs). We can do this using the All Chain UIDs GQL query.
query All_chain_uids {
  chains {
    all_chain_uids {
      chain_uid
      display_name
    }
  }
}
  1. Obtaining the Chain ID for a Specific UID: Once you have the list of UIDs, the next step is to get the specific chain ID associated with the UID you’re interested in. We can do this using the Chain ID GQL query:
tip

Use the chain UID you want the config for as the parameter.

query Chain_id($chainUid: String!) {
  chains {
    chain_id(chain_uid: $chainUid) {
      chain_id
    }
  }
}
  1. Fetching the Full Chain Config: Finally, with the chain ID in hand, you can fetch the complete configuration details for that chain using the Chain Config query:
tip

You can specify what info to return inside the query.

query Query($chainId: String!) {
chains {
  chain_config(chainId: $chainId) {
    chainID
    chainName
    rpc
    rest
  }
}
}

Example Response:

{
"data": {
  "chains": {
    "chain_config": {
      "chainID": "localwasma-1",
      "chainName": "Wasm Devnet",
      "rpc": "https://api.euclidprotocol.com:20141",
      "rest": "https://api.euclidprotocol.com:20241",
      "coinType": 118
    }
  }
}
}