# How to Query Contracts ## The SYMMIO Diamond SYMMIO's core contracts are implemented with **EIP-2535**, a solution for building modular and upgradeable contracts. #### **EIP-2535: Diamond Standard Overview** EIP-2535 introduces the Diamond Standard in smart contract development. This standard centralizes around the concept of a "Diamond" contract, which is constructed from multiple "facets," each responsible for different functionalities. This modular design enhances maintainability by allowing facets to be upgraded or modified independently without affecting the entire contract. Key to this architecture are function selectors, which serve as unique identifiers for each function within the facets. These selectors efficiently direct function calls to the correct facet, facilitating organized and conflict-free code execution. For further reading and technical details, refer to the [official EIP-2535 documentation](https://eips.ethereum.org/EIPS/eip-2535). When a facet, is invoked via a `delegatecall` from the Diamond, it operates directly on the Diamond’s storage. The facet uses the slot address computed by the library to access or modify the data in the specific storage slot. This operation is transparent to the Diamond itself. ### Finding Facet Contracts In the SYMM Diamond, the `facets()` function of the `DiamondLoupeFacet` plays a crucial role in inspecting the contract's structure and behaviour. When this function is called on the Diamond, it returns an array of `Facet` structs, each containing the address of a facet along with the specific function selectors associated with that facet. To examine the facets and call functions on them, we'll use a tool called [Louper](https://louper.dev). This platform displays all facets and functions related to a Diamond contract and allows us to query data directly from them. Since functions cannot be called on through the Diamond contract directly through a blockchain explorer, Louper provides an efficient and user-friendly way to interact with the Diamond. ### Using Louper to Read Data In this example, we'll use Louper to find all the contract symbols available to trade on Thena. First, paste the address into the tool and select the appropriate chain (BNB):
Then, click the **Read** tab, and select the View Facet. This shows all the view functions available to query on the Diamond.
Now you can query the symbols available to trade on the Diamond using `getSymbols()` with `start` and `size` as parameters:
For more information on the View Facet's functions, please refer to the [ViewFacet ](https://app.gitbook.com/o/-McFr-NnfqafWnoj_Y5M/s/YQhBmTCs9MwhhuPQrV5v/~/changes/474/building-on-symm-io/technical-documentation/contracts-documentation-0.8.2/facets/view-facet)documentation (0.8.2). ## Using Subgraphs to Query Data The Graph is a decentralized protocol for indexing and querying blockchain data. You can also query data on the diamond using a subgraph URL provided by SYMM. In this example, we'll query the symbol data using the Apollo Client. **Prerequisites** * Basic understanding of GraphQL * A tool for making HTTP requests, such as Postman, cURL, or a GraphQL client like Apollo Client **Endpoint URL** First identify a suitable endpoint: ``` https://api.studio.thegraph.com/query/62454/analytics_bnb_8_2/version/latest ``` This endpoint is the analytics endpoint for the SYMMIO Diamond on BNB. **Example Query** To fetch data, send a POST request to the endpoint with the GraphQL query: ```graphql query MyQuery { symbols(first: 3) { blockNumber id name timestamp tradingFee updateTimestamp } } ``` **Using cURL** ```sh shCopy codecurl -X POST \ -H "Content-Type: application/json" \ -d '{"query":"query MyQuery { symbols(first: 3) { blockNumber id name timestamp tradingFee updateTimestamp } }"}' \ https://api.studio.thegraph.com/query/62454/analytics_bnb_8_2/version/latest ``` ### **Using Apollo Client in React** #### Install Apollo Client: ```bash npm install @apollo/client graphql ``` #### Set up Apollo Client and make the query: ```javascript import React from 'react'; import { ApolloClient, InMemoryCache, ApolloProvider, useQuery, gql } from '@apollo/client'; const client = new ApolloClient({ uri: 'https://api.studio.thegraph.com/query/62454/analytics_bnb_8_2/version/latest', cache: new InMemoryCache() }); const GET_SYMBOLS = gql` query MyQuery { symbols(first: 3) { blockNumber id name timestamp tradingFee updateTimestamp } } `; const DataComponent = () => { const { loading, error, data } = useQuery(GET_SYMBOLS); if (loading) return

Loading...

; if (error) return

Error :(

; return (

Symbols

{data.symbols.map(symbol => (

{symbol.name}

Block Number: {symbol.blockNumber}

Timestamp: {new Date(symbol.timestamp * 1000).toLocaleString()}

Trading Fee: {symbol.tradingFee}

Update Timestamp: {new Date(symbol.updateTimestamp * 1000).toLocaleString()}

))}
); }; const App = () => ( ); export default App; ``` ## Subgraph URLs by Chain ### Arbitrum #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/arbitrum_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/arbitrum_events/latest/gn) ### Mantle #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/mantle_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/mantle_events/latest/gn) ### BNB #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/bnb_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/bnb_events/latest/gn) ### Base #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/base_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/base_events/latest/gn) ### Berachain #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/bera_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/bera_events/latest/gn) ### Mode #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/mode_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/mode_events/latest/gn) ### Iota #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/iota_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/iota_events/latest/gn) ### Polygon #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/polygon_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/polygon_events/latest/gn) ### Blast #### [Analytics Subgraph](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/blast_analytics/latest/gn) [**Events Subgraph**](https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/blast_events/latest/gn) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.symm.io/trader-documentation/interacting-with-contracts/how-to-query-contracts.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.