You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
// getMyCounter (call signature 916d5743) returns the counter value for this chain. It is meant to be used in a cross chain query.
60
+
function getMyCounter() publicviewreturns (uint256) {
61
+
return counters[myChainID].counter;
62
+
}
63
+
64
+
// getState() returns this chain's view of all the counters. It is meant to be used in the front end.
65
+
function getState() publicviewreturns (ChainEntry[] memory) {
66
+
ChainEntry[] memory ret =newChainEntry[](foreignChainIDs.length+1);
67
+
ret[0] = counters[myChainID];
68
+
uint256 length = foreignChainIDs.length;
69
+
70
+
for (uint256 i =0; i < length;) {
71
+
ret[i +1] = counters[foreignChainIDs[i]];
72
+
unchecked {
73
+
++i;
74
+
}
75
+
}
76
+
77
+
return ret;
78
+
}
79
+
80
+
// @notice Takes the cross chain query response for the other counters, stores the results for the other chains, and updates the counter for this chain.
81
+
function updateCounters(bytesmemoryresponse, IWormhole.Signature[] memorysignatures) public {
82
+
ParsedQueryResponse memory r =parseAndVerifyQueryResponse(response, signatures);
83
+
uint256 numResponses = r.responses.length;
84
+
if (numResponses != foreignChainIDs.length) {
85
+
revertUnexpectedResultLength();
86
+
}
87
+
88
+
for (uint256 i =0; i < numResponses;) {
89
+
// Create a storage pointer for frequently read and updated data stored on the blockchain
description: Explore frequently asked questions about Wormhole Queries, which offer on-demand access to guardian-attested on-chain data via a REST API endpoint.
4
+
---
5
+
6
+
# FAQs about Queries
7
+
8
+
## What Libraries Are Available to Handle Queries?
9
+
10
+
- The [Query TypeScript SDK](https://npmjs.com/package/@wormhole-foundation/wormhole-query-sdk){target=\_blank} can be used to create query requests, mock query responses for testing, and parse query responses. The SDK also includes utilities for posting query responses
11
+
12
+
- The [Solidity `QueryResponse` abstract contract](https://github.com/wormhole-foundation/wormhole-solidity-sdk/blob/main/src/QueryResponse.sol){target=\_blank} can be used to parse and verify query responses on EVM chains. See the [Solana Stake Pool](https://github.com/wormholelabs-xyz/example-queries-solana-stake-pool){target=\_blank} repository as an example use case
13
+
14
+
-[`QueryTest.sol`](https://github.com/wormhole-foundation/wormhole-solidity-sdk/blob/main/src/testing/helpers/QueryTest.sol){target=\_blank} can be used for mocking query requests and responses in Forge tests
15
+
16
+
- The [Go query package](https://github.com/wormhole-foundation/wormhole/tree/main/node/pkg/query){target=\_blank} can also be used to create query requests and parse query responses
17
+
18
+
!!! note
19
+
A Rust SDK for Solana is being actively investigated by the Wormhole contributors. See the [Solana Queries Verification](https://github.com/wormholelabs-xyz/example-queries-solana-verify){target=\_blank} repository as a proof of concept.
20
+
21
+
## Are There Any Query Examples?
22
+
23
+
Certainly. You can find a complete guide on the [Hands on with Queries page](/build/build-apps/queries/hands-on-with-queries). Additionally, you can find full code examples in available in the following repositories:
24
+
25
+
-[Basic Example Query Demo](https://github.com/wormholelabs-xyz/example-queries-demo/){target=\_blank}
26
+
-[Solana Stake Pool Example Query](https://github.com/wormholelabs-xyz/example-queries-solana-stake-pool){target=\_blank}
27
+
-[Solana PDA / Token Account Balance Example Query](https://github.com/wormholelabs-xyz/example-queries-solana-pda){target=\_blank}
The Guardian node calculates an ECDSA signature using [`Sign` function of the crypto package](https://pkg.go.dev/github.com/ethereum/go-ethereum@v1.10.21/crypto#Sign){target=\_blank} where the digest hash is:
See the [Guardian Key Usage](https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0009_guardian_key.md){target=\_blank} white paper for more background. Once this signature is created, the Guardian's index in the Guardian set is appended to the end.
37
+
38
+
!!! note
39
+
If you are used to `ecrecover` you will notice that the `v` byte is `0` or `1` as opposed to `27` or `28`. The `signaturesToEvmStruct` method in the [Query TypeScript SDK](https://npmjs.com/package/@wormhole-foundation/wormhole-query-sdk){target=\_blank} accounts for this as well as structuring the signatures into an `IWormhole.SignatureStruct[]`.
40
+
41
+
## Can Anyone Run a Query Proxy Server?
42
+
43
+
Permissions for Query Proxy are managed by the Guardians. The Guardian nodes are configured to only listen to a set of allow-listed proxies. However, it is possible that this restriction may be lifted in the future and/or more proxies could be added.
44
+
45
+
It is also important to note that the proxies don't impact the verifiability of the request or result, i.e., their role in the process is trustless.
0 commit comments