# 查詢與變動方法
OCAP 客戶端透過 GraphQL 與區塊鏈互動。方法分為兩大類：
* **查詢 (Queries)**：這些是唯讀操作，用於從區塊鏈擷取資料，例如檢索帳戶狀態、列出交易或取得一般鏈資訊。它們不會改變鏈的狀態。
* **變動 (Mutations)**：這些是會修改區塊鏈狀態的寫入操作。傳送交易是變動的主要範例。
本節提供客戶端所有可用的查詢與變動方法的完整參考。
## 查詢方法
查詢用於從區塊鏈中檢索資料。以下是所有可用查詢方法的完整列表。
### `getAccountState`
檢索特定帳戶的目前狀態，包括其餘額、nonce 及其他詳細資訊。
**參數**
**傳回值**
### `getAssetState`
檢索特定資產（NFT）的目前狀態。
**參數**
**傳回值**
### `getFactoryState`
擷取特定資產工廠的狀態。
**參數**
**傳回值**
### `getDelegateState`
檢索委託關係的狀態。
**參數**
**傳回值**
### `getTokenState`
擷取特定同質化代幣的狀態。
**參數**
**傳回值**
### `getEvidenceState`
根據其雜湊值檢索證據記錄。
**參數**
**傳回值**
### `getForgeState`
擷取 OCAP 區塊鏈的整體設定與狀態。
**參數**
**傳回值**
### `getTokenFactoryState`
檢索特定代幣工廠的狀態。
**參數**
**傳回值**
### `getTx`
根據其雜湊值擷取單一交易。
**參數**
**傳回值**
### `getBlock`
根據其高度檢索單一區塊。
**參數**
**傳回值**
### `getBlocks`
檢索區塊列表，可選用篩選條件。
**參數**
**傳回值**
### `getUnconfirmedTxs`
擷取在記憶體池中但尚未確認的交易。
**參數**
**傳回值**
### `getChainInfo`
檢索關於區塊鏈的一般資訊。
**參數**
此方法不接受任何參數。
**傳回值**
### `getConfig`
擷取節點的設定。
**參數**
**傳回值**
### `getNetInfo`
檢索網路資訊，包括已連線的對等節點。
**參數**
此方法不接受任何參數。
**傳回值**
### `getNodeInfo`
檢索關於被查詢的特定節點的資訊。
**參數**
此方法不接受任何參數。
**傳回值**
### `getValidatorsInfo`
擷取關於目前驗證者集合的資訊。
**參數**
此方法不接受任何參數。
**傳回值**
### `getForgeStats`
檢索關於區塊鏈活動的各種統計數據。
**參數**
此方法不接受任何參數。
**傳回值**
### `listAssetTransactions`
列出與特定資產相關的所有交易。
**參數**
**傳回值**
### `listAssets`
列出所有資產，可依擁有者或工廠進行篩選。
**參數**
**傳回值**
### `listBlocks`
列出區塊，提供多種篩選選項。
**參數**
**傳回值**
### `listTopAccounts`
列出特定代幣餘額最高的帳戶。
**參數**
**傳回值**
### `listTransactions`
一個功能強大的方法，能以多種篩選條件列出交易。
**參數**
**傳回值**
### `listTokens`
列出鏈上所有的同質化代幣。
**參數**
**傳回值**
### `listFactories`
列出鏈上所有的資產工廠。
**參數**
**傳回值**
### `getAccountTokens`
檢索特定帳戶的代幣餘額。
**參數**
**傳回值**
### `getStakeState`
擷取特定質押的狀態。
**參數**
**傳回值**
### `listStakes`
列出所有質押記錄，可選用篩選條件。
**參數**
**傳回值**
### `getRollupState`
檢索特定 rollup 的狀態。
**參數**
**傳回值**
### `listRollups`
列出鏈上所有的 rollup。
**參數**
**傳回值**
### `getRollupBlock`
從 rollup 側鏈擷取特定區塊。
**參數**
**傳回值**
### `listRollupBlocks`
列出 rollup 側鏈的區塊。
**參數**
**傳回值**
### `listRollupValidators`
列出特定 rollup 的驗證者。
**參數**
**傳回值**
### `listDelegations`
列出所有委託記錄。
**參數**
**傳回值**
### `search`
對帳戶、資產或交易進行關鍵字搜尋。
**參數**
**傳回值**
### `estimateGas`
估算交易所需的 gas。
**參數**
**傳回值**
### `listTokenFlows`
追蹤帳戶之間的代幣流動。
**參數**
**傳回值**
### `verifyAccountRisk`
評估指定帳戶的風險狀況。
**參數**
**傳回值**
### `getTokenDistribution`
檢索指定代幣的分佈統計數據。
**參數**
**傳回值**
### `listTokenFactories`
列出鏈上所有的代幣工廠。
**參數**
**傳回值**
## 變動方法
變動用於傳送會修改區塊鏈狀態的交易。
### `sendTx`
將預先簽署的交易廣播到網路。這是所有寫入操作的基礎方法。關於建立和簽署交易，請參閱 [高階 API](./api-reference-transaction-helpers.md) 和 [交易生命週期](./core-concepts-transaction-lifecycle.md) 指南。
**參數**
**傳回值**
**範例**
```javascript icon=logos:javascript
// 此範例假設 `signedTx` 是一個經過適當編碼和簽署的交易字串。
// 關於如何建立它，請參閱其他指南。
const signedTx = '...';
const wallet = { ... }; // 簽署此交易的錢包
try {
const { hash } = await client.sendTx({ tx: signedTx, wallet });
console.log('Transaction sent successfully! Hash:', hash);
} catch (error) {
console.error('Failed to send transaction:', error);
}
```