> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequence.xyz/llms.txt
> Use this file to discover all available pages before exploring further.
# ブロックチェーンからのデータ取得
> Sequence インフラスタックを用いた web3 ゲーム向け Unreal SDK API のブロックチェーン読み取りに関するドキュメントです。
## チェーンIDの設定
ユーザー情報を取得したいチェーンIDを選択します。デフォルトではPolygonが設定されています。
**新しいチェーンタイプ（ENetwork Enum）**
情報を取得したいチェーンの種類を選択します。Ethereum MainnetやSepoliaなどが含まれます。SequenceのBuilderでプロジェクトに合ったチェーンを必ず選択してください。
## Ether残高の取得
Indexer APIを利用して、指定したウォレットアドレス（例：ローカルユーザーのアドレス）のEther残高を取得します。
```cpp twoslash theme={null}
// Define success and failure callbacks
const TSuccessCallback GenericSuccess = [=](const FEtherBalance& etherBalance) { };
const FFailureCallback GenericFailure = [=](const FSequenceError& Error) { };
// Get a reference of the user's current wallet session.
const TOptional WalletOptional = USequenceWallet::Get();
if (WalletOptional.IsSet() && WalletOptional.GetValue())
{
// Example Indexer call
USequenceWallet * Wallet = WalletOptional.GetValue();
Wallet->GetEtherBalance(Wallet->GetWalletAddress(), GenericSuccess, GenericFailure);
}
```
**ウォレットアドレス（FString）**
データを取得したいウォレットアドレスを指定します。
**残高（Integer64）**
指定したウォレットアドレスが保有するEtherの量です。
## トークン残高の取得
ERC20、ERC721、ERC1155トークンのユーザー残高を取得します。これにより、ユーザーが所有するすべてのトークンの配列が返されます。
```cpp theme={null}
const TSuccessCallback GenericSuccess = [=](const FGetTokenBalancesReturn& tokenBalances)
{
//Response in FGetTokenBalancesReturn
};
const FFailureCallback GenericFailure = [=](const FSequenceError& Error)
{
//GetTokenBalances Failure
};
const TOptional WalletOptional = USequenceWallet::Get();
if (WalletOptional.IsSet() && WalletOptional.GetValue())
{
USequenceWallet * Wallet = WalletOptional.GetValue();
FGetTokenBalancesArgs args;
args.accountAddress = Wallet->GetWalletAddress();
args.includeMetaData = true;
Wallet->GetTokenBalances(args, GenericSuccess, GenericFailure);
}
```
**コントラクトアドレス（FString）**
データを取得したいERC20、ERC721、またはERC1155のコントラクトアドレスです。
**ウォレットアドレス（FString）**
指定したコントラクトアドレス上でトークンを所有しているウォレットアドレスです。
**メタデータを含める（Boolean）**
レスポンスにトークンのメタデータを含めたい場合は、このフラグを有効にしてください。
**残高（SeqGetTokenBalancesReturn Struct）**
指定したウォレットアドレスが所有するすべてのトークンIDをリスト化したSeqTokenBalance配列が含まれます。'メタデータを含める'がtrueの場合、トークンのメタデータも含まれます。
## トークン供給量の取得
ERC20、ERC721、ERC1155トークンの供給量を取得します。
```cpp theme={null}
const TSuccessCallback GenericSuccess = [=](const FGetTokenSuppliesReturn& tokenSupplies)
{
//Response is in FGetTokenSuppliesReturn
};
const FFailureCallback GenericFailure = [=](const FSequenceError& Error)
{
//GetTokenSupplies Failure
};
const TOptional WalletOptional = USequenceWallet::Get();
if (WalletOptional.IsSet() && WalletOptional.GetValue())
{
USequenceWallet * Wallet = WalletOptional.GetValue();
FGetTokenSuppliesArgs args;
args.contractAddress = "0x01";//Testing Contract Address in hex with leading 0x
args.includeMetaData = true;
Wallet->GetTokenSupplies(args, GenericSuccess, GenericFailure);
}
```
**コントラクトアドレス（FString）**
トークン供給量を取得したいERC20、ERC721、またはERC1155のコントラクトアドレスです。
**メタデータを含める（Boolean）**
レスポンスにトークンのメタデータを含めたい場合は、このフラグを有効にしてください。
**供給量（SeqGetTokenSuppliesReturn Struct）**
指定したコントラクトアドレス上で利用可能なすべてのトークンIDをリスト化したSeqTokenSupply配列が含まれます。各要素には'supply'値が含まれます。'メタデータを含める'がtrueの場合、トークンのメタデータも含まれます。
## トークン供給量マップの取得
ERC20、ERC721、ERC1155トークンの供給量コレクションを取得します。
```cpp theme={null}
const TSuccessCallback GenericSuccess = [=](const FGetTokenSuppliesMapReturn& tokenSuppliesMap)
{
//Response is in FGetTokenSuppliesMapReturn
};
const FFailureCallback GenericFailure = [=](const FSequenceError& Error)
{
//GetTokenSuppliesMap Failure
};
const TOptional WalletOptional = USequenceWallet::Get();
if (WalletOptional.IsSet() && WalletOptional.GetValue())
{
USequenceWallet * Wallet = WalletOptional.GetValue();
TMap tokenMap;
const TPair item;
tokenMap.Add(item);
FGetTokenSuppliesMapArgs args;
args.includeMetaData = true;
args.tokenMap = tokenMap;
Wallet->GetTokenSuppliesMap(args, GenericSuccess, GenericFailure);
}
```
**トークンマップ（FString->FSeqTokenList Map）**
データを取得したいトークンIDのマップです。
**メタデータを含める（Boolean）**
レスポンスにトークンのメタデータを含めたい場合は、このフラグを有効にしてください。
**供給量（SeqGetTokenSuppliesMapReturn Struct）**
'トークンマップ'で指定した各IDごとにSeqTokenSupply配列が含まれます。各要素には'supply'値が含まれます。'メタデータを含める'がtrueの場合、トークンのメタデータも含まれます。
## トランザクション履歴の取得
ウォレットアドレスまたはトークンアドレスのトランザクション履歴を取得します。
例えば、現在のユーザーのすべてのトランザクションを取得できます。
```cpp theme={null}
const TSuccessCallback GenericSuccess = [=](const FGetTransactionHistoryReturn& transactionHistory)
{
//Response is in FGetTransactionHistoryReturn
};
const FFailureCallback GenericFailure = [=](const FSequenceError& Error)
{
//GetTransactionHistory Failure
};
const TOptional WalletOptional = USequenceWallet::Get();
if (WalletOptional.IsSet() && WalletOptional.GetValue())
{
USequenceWallet * Wallet = WalletOptional.GetValue();
FGetTransactionHistoryArgs args;
args.filter.accountAddress = Wallet->GetWalletAddress();
args.includeMetaData = true;
args.page.page = 0;
args.page.more = true;
Wallet->GetTransactionHistory(args, GenericSuccess, GenericFailure);
}
```
**アカウントアドレス（FString）**
特定ユーザーの履歴を取得したい場合はウォレットアドレスを指定します。
**コントラクトアドレス（FString）**
特定トークンの履歴を取得したい場合はERC20、ERC721、またはERC1155のコントラクトアドレスを指定します。
**メタデータを含める（Boolean）**
レスポンスにトークンのメタデータを含めたい場合は、このフラグを有効にしてください。
**トランザクション履歴（SeqGetTransactionHistoryReturn Struct）**
すべてのトランザクションをリスト化したSeqTransaction配列が含まれます。