> ## 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.

# スマートコントラクト

既にデプロイ済みのコントラクトに対して `Contract` オブジェクトを作成するのは容易です。

```csharp theme={null}
Contract contract = new Contract(contractAddress, abi);
```

必須ではありませんが、コントラクトオブジェクト作成時にはコントラクトABIを文字列で指定することを<i>強く</i>推奨します。指定しない場合、ABIのエンコード・デコード機能を十分に活用できません。
この方法を選択した場合、関数呼び出しやクエリ時には関数名＋パラメータ型（例：ERC20のtransferメソッドなら transfer(address,uint256)）を完全な関数シグネチャとして指定する必要があり、クエリの返り値も常に文字列となります。

## スマートコントラクト関数の呼び出し

スマートコントラクトを呼び出すには、`CallFunction` メソッドを使って `CallContractFunction` オブジェクトを作成します。これにより、クライアントと `ContractCall` オブジェクトを `Create` async Task に渡すことで、適切なgasPrice、gasLimit、nonce、dataを含む新しい `EthTransaction` を組み立てます。

スマートコントラクトを呼び出す例は以下の通りです。

```csharp theme={null}
Contract erc20Contract = new Contract(contractAddress, contractAbi); // We'll use the well-known ERC20 contract as our example case
TransactionReceipt receipt = await erc20Contract.CallFunction("transfer", toAddress, amountAsBigInteger).SendTransactionMethodAndWaitForReceipt(wallet, client);
```

注意：レシートを待たずに送信したい場合は、`SendTransactionMethod` を利用できます。

また、`EthTransaction` の作成だけを行い、後で送信したい場合は、`CallFunction` から直接 `CallContractFunction` オブジェクトを利用できます。

```csharp theme={null}
Contract erc20Contract = new Contract(contractAddress, contractAbi); // We'll use the well-known ERC20 contract as our example case
EthTransaction transaction = await erc20Contract.CallFunction("transfer", toAddress, amountAsBigInteger).Create(client, new ContractCall(wallet.GetAddress()));
TransactionReceipt receipt = await wallet.SendTransactionAndWaitForReceipt(client, transaction);

// or 
CallContractFunction transactionCreator = erc20Contract.CallFunction("transfer", toAddress, amountAsBigInteger);
EthTransaction transaction = await transactionCreator.Create(client, new ContractCall(wallet.GetAddress()));
TransactionReceipt receipt = await wallet.SendTransactionAndWaitForReceipt(client, transaction);

// or 
CallContractFunction transactionCreator = erc20Contract.CallFunction("transfer", toAddress, amountAsBigInteger);
TransactionReceipt receipt = await transactionCreator.SendTransactionMethodAndWaitForReceipt(wallet, client);
```

`CallFunction` メソッドは任意の数の引数を受け取れることに気づくでしょう。ABIや関数シグネチャで定義された順番通りに引数を渡してください。

## データ型マッピングの理解

スマートコントラクトとやり取りする際、EVMのデータ型がSequenceEthereumライブラリ内でC#のデータ型にどのようにマッピングされているかを理解することが重要です。

例えば、ABIが整数を期待している箇所に文字列を渡した場合、その文字列が整数に変換可能であっても例外が発生します。

### アドレス

C#では、`string`型を使うか、`Address`のインスタンスを作成することができます。文字列の場合は、必ず`0x`で始まり、42文字の固定長である16進数文字列であることを確認してください。

```csharp theme={null}
Address address = new Address("0x123...");
```

### 整数型

`int256`、`uint8`、`uint256`などの整数型には、System.Numericsの`BigInteger`型を使用します。

```csharp theme={null}
// Simple number
BigInteger number = new BigInteger(10000);

// From hex
string hexString = "0x0000000...01";
BigInteger number = hexString.HexStringToBigInteger();
```

### バイト型

Solidityのバイト型データをC#で定義するには、`byte16`や`byte32`などの型には`FixedByte`を作成する方法があります。
コントラクトで`bytes`型が必要な場合は、任意の値を任意の長さの`byte[]`に変換できます。

C#でデータが16進数文字列として表現されている場合は、`HexStringToByteArray()`関数を使って、その値を元のバイト配列に変換してください。

`byte32[]`のようなバイト配列は、C#では単純に`FixedByte[]`として作成します。

```csharp theme={null}
// byte16 or byte32
new FixedByte(16, new byte[] {});

// bytes
string someString = "abc0123456789";
byte[] bytes = someString.ToByteArray();

// signature
string signature = "0x0ab123...";
byte[] bytes = signature.HexStringToByteArray();
```

### 構造体

オンチェーン関数に構造体を渡す場合は、タプルを使用します。以下はSolidityの構造体の例と、それをSequenceのUnity SDKでどのように定義し、`Contract.CallFunction`関数の引数として渡すかの例です。

Solidity構造体

```solidity theme={null}
struct ExampleStruct {
    address wallet;
    uint256 amount;
    byte32 data;
}
```

C#での対応例

```csharp theme={null}
Address wallet = new Address("0x...");
BigInteger amount = new BigInteger(10000);
FixedByte data = new FixedByte(32, byteArrayData);
var arg = new Tuple<Address, BigInteger, FixedByte>(wallet, amount, data);
```

### その他の型

Solidityの`string`や`bool`などの基本的なデータ型は、C#でも同じデータ型を使用できます。

### 返却型

スマートコントラクトからデータを読み取り、`Contract.SendQuery<TType>()` 関数を使用する場合、`string`、`BigInteger`、`bool` などの単純な戻り値型には TType をそのまま使うことができます。構造体のような複雑な戻り値型の場合は、`object[]` を使用し、値を手動で C# の構造体にパースしてください。

```csharp theme={null}
// Let's consider a struct with the following variables: SomeStruct { address value1; uint256 value2; }
object[] structValues = Contract.SendQuery<object[]>("SomeFunction");

SomeStruct newStruct = new SomeStruct() {
    Value1 = new Address(structValues[0].ToString()),
    Value2 = BigInteger.Parse(structValues[1].ToString())
}
```

## コントラクトのクエリ

スマートコントラクトからデータを読み取る場合は、`SendQuery<T>`メソッドを使ってコントラクトにクエリを送り、結果を型Tで受け取ります。
スマートコントラクトをクエリする例は以下の通りです。

```csharp theme={null}
Contract erc20Contract = new Contract(contractAddress, contractAbi); // We'll use the well-known ERC20 contract as our example case
BigIntegar balance = await erc20Contract.SendQuery<BigIntegar>(client, "balanceOf", address);
```

また、クエリを作成して後で送信したい場合は、`QueryContract<T>`を使ってデリゲートを作成できます。

```csharp theme={null}
Contract erc20Contract = new Contract(contractAddress, contractAbi); // We'll use the well-known ERC20 contract as our example case
QueryContractMessageSender<BigIntegar> balanceQuery = erc20Contract.QueryContract<BigIntegar>("balanceOf", address);
BigIntegar balance = await balanceQuery(client);
// or
BigIntegar balance = await balanceQuery.SendQuery(client);
```

## コントラクトのデプロイ

コントラクトをデプロイしたい場合は、`ContractDeployer`を利用できます。

```csharp theme={null}
ContractDeploymentResult deploymentResult = await ContractDeployer.Deploy(client, wallet, contractBytecodeAsString);
string newlyDeployedContractAddress = deploymentResult.Receipt.contractAddress;
```