> For the complete documentation index, see [llms.txt](https://help.keyring.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.keyring.app/jp/keyring-one/what-is-keyring-one.md).

# キーリング・ワンとは

キーリング・ワンは、企業、組織、ウェブ３チーム向けの、資産を預からないオンチェーン財務管理・自動化プラットフォームです。個人のウォレット利用者向けに、分散型金融の機能も提供しています。

共有資産の管理、定期的な収益分配、レンディング、取引を、１つの画面から利用できます。組織は共有資金の承認ルールを設定し、定期的な処理を自動化できます。個人利用者は、対応するレンディングプロトコルを利用したり、ユニスワップ第４版を通じて注文したりできます。

マルチシグアカウントの機能では、共有アカウントの資産を使用し、各機能に適用される承認ルールに従って処理が行われます。

> <mark style="color:green;">**注意：**</mark> <mark style="color:green;">**取引機能の指値注文**</mark><mark style="color:green;">や</mark><mark style="color:green;">**レンディング**</mark><mark style="color:green;">などの分散型金融機能は、利用者が接続した</mark><mark style="color:green;">**単独のウォレット**</mark><mark style="color:green;">を通じて、そのウォレット内の資産を使用します。マルチシグアカウントや、その共有資産は使用しません</mark>。

**透明性のある、資産を預からない基盤**

キーリング・ワンは、利用者や組織の資産を預かりません。資産は、各機能のルールに従い、関連するスマートコントラクトと、権限を持つウォレットまたは署名者によって処理されます。

実行されたコントラクト取引と資産の移動は、ブロックチェーン上に記録され、第三者が独立して確認できます。マルチシグアカウントの監査報告書と、公開されている `LimitOrderHook` のソースコードは、それぞれ該当する仕組みを確認するための資料です。

## 監査とソースコード

**１．マルチシグアカウントの監査：ブロックセック**

[キーリングのマルチシグウォレットコントラクトに関する、ブロックセックのセキュリティ監査報告書](https://blocksec.com/audit-report/audit-report-keyring-s-multisig-wallet-contracts-1784184202)

{% embed url="<https://blocksec.com/audit-report/audit-report-keyring-s-multisig-wallet-contracts-1784184202>" %}

この報告書には、指定されたキーリングのマルチシグアカウントのコントラクトに対して、ブロックセックが実施した独立した検証の内容が記載されています。監査範囲、検出事項、検証対象のコードの版を確認できます。

**２．検証済みの指値注文フックのソースコード**

[ベーススキャンで公開されている指値注文フックのコントラクトのソースコード](https://basescan.org/address/0xEEee3DA335342996Ab288fBcF70fBe5F9ED81040#code)

{% embed url="<https://basescan.org/address/0xEEee3DA335342996Ab288fBcF70fBe5F9ED81040#code>" %}

ベース上のアドレス `0xEEee3DA335342996Ab288fBcF70fBe5F9ED81040` に配置された `LimitOrderHook` の公開ソースコードです。依存するコードも含まれています。以下のコード解説では、このソースコードを使用しています。

**３．ユニスワップのフックリストへの提出情報**

[スマート指値注文フックの提出情報](https://github.com/Uniswap/hooklist/issues/10506)

{% embed url="<https://github.com/Uniswap/hooklist/issues/10506>" %}

この提出情報では、フックの概要、配置先のネットワークであるベース、コントラクトアドレスが示されています。仕組みを説明するための提出情報であり、監査報告書やユニスワップによる推奨を意味するものではありません。

## マルチシグアカウントの監査

キーリング・ワンのマルチシグアカウントのスマートコントラクトは、ブロックチェーンのセキュリティ企業である[ブロックセック](https://blocksec.com/)による独立した監査を受けています。

ブロックセックの公開資料によると、同社は１，０００以上の顧客を持ち、５００億米ドルを超えるデジタル資産の保護に携わっています。公開されている監査実績には、パンケーキスワップ、オーケーエックス・スマートウォレット、ラビーウォレットが含まれます。

**監査の対象**

ブロックセックは、キーリング・ワンのマルチシグアカウントで使用される、次のような主要なスマートコントラクトの処理を検証しました。

* マルチシグアカウントの作成。
* 署名者と必要署名数の設定。
* 署名の検証。
* 資産の引き出しに対する権限確認。
* 引き出し要求の再利用による攻撃の防止。
* ネイティブトークンおよび対応するブロックチェーン資産の、スマートコントラクトによる処理。

検証では、自動的な脆弱性検査、手作業によるコードの検証、コントラクトの業務ロジックの分析を組み合わせています。

監査の対象は、報告書に記載されたコードの版と範囲に限られます。キーリング・ワンのすべての機能や、以下で説明する `LimitOrderHook` まで監査されたことを意味するものではありません。

> **この監査により、利用者は、署名者の承認を確認し、共有アカウントからの引き出しを許可する処理など、検証対象となったマルチシグの実装について、独立した評価を確認できます。**

## 指値注文を支えるコード

キーリング・ワンの指値注文機能は、ユニスワップ第４版上の独自の `LimitOrderHook` を通じて動作します。コードが公開されているため、注文の仕組みを第三者が独立して検証できます。

このフックは、オープンツェッペリンが開発した、ユニスワップ向けフックのオープンソースライブラリを基盤としています。オープンツェッペリンは、広く利用されているスマートコントラクトのライブラリやセキュリティサービスで知られる、実績のあるブロックチェーンのセキュリティ企業です。キーリング・ワンの実装は、この基盤に変更を加えたものであり、変更内容はソースコードに記載されています。

以下の分析は、ベース上に配置され、ソースコードの検証が行われた `LimitOrderHook` と、それに含まれる依存コードを対象としています。指定したスケジュールで動作する自動指値注文など、プラットフォームのその他の機能の実装は分析対象に含まれません。

抜粋では、一部のコメントと前後のコードを省略し、読みやすいように字下げを調整しています。元のコードの命令文は変更していません。

**ユニスワップ第４版のフックとは**

ユニスワップ第４版のフックは、流動性プールに独自の処理を追加するスマートコントラクトです。ユニスワップ第４版は、フックの設定で有効にされたプール操作の段階で、そのフックを呼び出します。

キーリング・ワンでは、`LimitOrderHook` が指値注文のオンチェーンの仕組みを実装しています。利用者による流動性の提供分を記録し、注文資産を狭い流動性の価格範囲に配置し、条件を満たす約定を処理するとともに、取り消しや引き出しに関する計算を行います。

**ユニスワップ第４版がフックを呼び出すタイミング**

フックは、`getHookPermissions()` を通じて、有効にするコールバックを宣言しています。

```solidity
function getHookPermissions() public pure virtual override returns (Hooks.Permissions memory permissions) {
    return Hooks.Permissions({
        beforeInitialize: false,
        afterInitialize: true,
        beforeAddLiquidity: false,
        beforeRemoveLiquidity: false,
        afterAddLiquidity: false,
        afterRemoveLiquidity: false,
        beforeSwap: false,
        afterSwap: true,
        beforeDonate: false,
        afterDonate: false,
        beforeSwapReturnDelta: false,
        afterSwapReturnDelta: false,
        afterAddLiquidityReturnDelta: false,
        afterRemoveLiquidityReturnDelta: false
    });
}
```

この実装では、次の２つのコールバックが有効になっています。

* **`afterInitialize`** は、プールの初期の下限ティックを記録し、ネイティブ通貨を含むプールを拒否します。
* **`afterSwap`** は、スワップによって通過した価格範囲を確認し、条件を満たす注文を処理します。

`false` に設定されている項目は、このフックでは有効にしていないコールバックです。

> **この設定により、プールでのスワップ後にフックの確認処理が実行されます。約定処理と組み合わせることで、約定時にウォレットから個別に承認しなくても、プール内の取引に応じて条件を満たす注文を処理できます。ただし、交換後の資産を受け取るには、利用者が引き出し取引を送信する必要があります。**

**スワップ後にフックが注文を処理する仕組み**

`_afterSwap()` 内では、フックが通過したティック範囲を特定し、基準値を更新して、該当する注文方向の処理を行います。

```solidity
(int24 tickLower, int24 lower, int24 upper) = _getCrossedTicks(key.toId(), key.tickSpacing);

if (lower > upper) return (this.afterSwap.selector, 0);

_tickLowerLasts[key.toId()] = tickLower;

bool zeroForOne = !params.zeroForOne;
for (; lower <= upper; lower += key.tickSpacing) {
    _fillOrder(key, lower, zeroForOne);
}

return (this.afterSwap.selector, 0);
```

ティックは、プール内の価格の境界を表します。`_getCrossedTicks()` は確認すべき範囲を特定し、`_fillOrder()` は、その範囲にある有効な注文を処理します。

このコールバックは、プールのスワップ処理の後、同じ取引内で実行されます。そのスワップによって条件を満たした注文をフックが約定処理する際に、利用者が別の取引へ署名する必要はありません。

実行は、該当するプール内の価格変動に依存します。このフックは、外部取引所の価格情報や、指定したスケジュールで価格を確認する仕組みを使用しません。

> **注文は、その注文が配置されたプール内のスワップによって進行します。別の取引所で表示されている価格だけで注文が約定するわけではないため、利用者は、実際のオンチェーンの注文状態を確認して、完了したかどうかを判断する必要があります。**

**各構成要素の連携**

* **キーリング・ワン**は、注文を作成・管理するための操作画面を提供します。
* **`LimitOrderHook`** は、注文に関する計算、約定処理、取り消し、引き出し、流動性提供手数料の振り分けを実装しています。
* **ユニスワップ第４版**は、これらの操作に使用されるプールの基盤を提供します。

ソースコードの冒頭には、このフックが、オープンツェッペリンのユニスワップ向けフックライブラリ第１．２．０版を変更したものであると記載されています。また、元本の計算、手数料の振り分け、引き出し時の計算、ネイティブ通貨への対応に関する変更が記録されています。

> **利用者はキーリング・ワンから注文を作成・管理し、フックとユニスワップ第４版がオンチェーンの処理を担当します。コントラクトが公開されているため、利用者や検証者は、操作画面とは独立して、これらの処理を確認できます。**

**キーリング・ワンの指値注文の仕組み**

オンチェーンの処理は、次の段階で進みます。

1. 利用者が、接続したウォレットを通じて注文を送信します。
2. フックが、呼び出し元による流動性の提供分を記録します。
3. 注文資産が、配置時点では現在価格の範囲外にある、狭い価格範囲の流動性ポジションに提供されます。
4. スワップによってプール価格がその範囲を通過すると、提供したトークンが、もう一方のトークンへ交換されます。
5. 必要な方向に価格範囲を完全に通過すると、フックが約定を処理し、交換後の資産を記録します。
6. 利用者が引き出し取引を送信し、自分の持ち分を受け取ります。

完了前であれば、利用者は自分の提供分を取り消し、その流動性を取り除くことで返却される元本を受け取れます。一部が交換されている場合、返却される資産には両方のトークンが含まれることがあります。

**注文の配置 → プールへの流動性提供 → トークンの交換 → 約定時の計算・記録 → 引き出し**

**注文の配置にはプール管理コントラクトを使用**

このコントラクトは、オープンツェッペリンの `BaseHook` を継承し、プール管理コントラクトのロック解除時のコールバック用インターフェースを実装しています。

```solidity
contract LimitOrderHook is BaseHook, IUnlockCallback {
```

注文の配置時には、`placeOrder()` がプール管理コントラクトにコールバックを要求します。

```solidity
poolManager.unlock(
    abi.encode(
        CallbackData(
            CallbackType.Place, abi.encode(PlaceCallbackData(key, msg.sender, zeroForOne, tick, liquidity))
        )
    )
);
```

このコールバックには、操作が注文配置であることを示す `Place` と、プール、呼び出し元、方向、下限ティック、流動性の数量が含まれています。

フックの `unlockCallback()` は、注文配置の処理を `_handlePlaceCallback()` に振り分けます。この処理は流動性を追加し、提供されたトークンについて、プール管理コントラクトとの決済を行います。

> **注文に指定したプール、方向、ティック、流動性は、オンチェーンの注文配置処理に渡されます。これらの内容によって取引で作成されるポジションが決まるため、利用者は確定前に注文内容を確認する必要があります。**

**注文資産はプール管理コントラクトへ移動**

公開されている依存コードの `CurrencySettler` には、外部の支払元に対する次の転送処理が含まれています。

```solidity
IERC20(Currency.unwrap(currency)).safeTransferFrom(payer, address(poolManager), amount);
```

この処理は、支払元からプール管理コントラクトへ `ERC-20` トークンを移動します。そのため、適切なトークン利用許可が必要です。

注文に使用されたトークンはウォレットから移動し、プールのポジションで使用されます。注文に使用している間は、そのウォレットから別の用途に使用することはできません。

フックの関数では、呼び出し元のアドレスと注文のパラメーターを使用します。入力として秘密鍵を要求することはありません。

> **注文に使用したトークンは、利用者のウォレットから使用できなくなります。提供分が有効な間は取り消しによって、注文が約定済みとして記録された後は引き出しによって、資産を受け取ります。**

**各利用者の提供分を個別に記録**

注文を配置すると、フックは流動性の合計と、呼び出し元の提供分の両方を更新します。

```solidity
orderInfo.liquidityTotal += liquidity;
orderInfo.liquidity[msg.sender] += liquidity;
```

有効な注文の識別子は、プールの情報、下限ティック、方向によって特定されます。

```solidity
return _orderIds[keccak256(abi.encode(key, tickLower, zeroForOne))];
```

複数の利用者が、同じ有効な注文範囲に流動性を提供できます。それぞれの流動性は、アドレスごとに個別に記録されます。

この記録によって、呼び出し元が取り消せる提供分と、約定後に受け取れる資産の持ち分が決まります。

> **複数の利用者が同じ注文範囲を共有している場合でも、各利用者の取り消しと引き出しは、自分に記録された提供分に基づいて行われます。ある利用者の提供分を取り消しても、ほかの利用者に記録された提供分は取り消されません。**

**目標価格を狭い流動性の価格範囲で表現**

フックは、ティック間隔１つ分の範囲に流動性を追加します。

```solidity
ModifyLiquidityParams({
    tickLower: placeData.tickLower,
    tickUpper: placeData.tickLower + key.tickSpacing,
    liquidityDelta: int256(uint256(placeData.liquidity)),
    salt: 0
})
```

下限は、注文で選択したティックです。上限は、そこから `tickSpacing` １つ分上の位置です。

注文配置の処理では、提供された資産が、指定した方向の範囲外ポジションに適合するかどうかを確認します。例えば、`currency0` を提供する分岐には、次の確認処理が含まれています。

```solidity
if (principalDelta.amount1() != 0) revert InRange();
if (!placeData.zeroForOne) revert CrossedRange();
```

もう一方の分岐では、`currency1` の提供について、対応する確認を行います。

注文は、プールのティックによって定義された価格区間で動作します。価格がその区間の一部に到達しただけでは、必ずしも注文が完全に完了したことにはなりません。

> **注文は狭い価格区間で動作します。利用者は、価格がその区間の一部に到達したことを、注文全体の完了と解釈しないようにする必要があります。価格範囲や方向の確認条件を満たさない注文配置は拒否されます。**

**フックは両方向の交換に対応**

注文配置の関数には、方向を指定する `zeroForOne` パラメーターが含まれています。

```solidity
function placeOrder(PoolKey calldata key, int24 tick, bool zeroForOne, uint128 liquidity) public virtual {
```

ソースコードには、次のように記載されています。

* `zeroForOne = true`：`currency0` を提供し、`currency1` を受け取ります。
* `zeroForOne = false`：`currency1` を提供し、`currency0` を受け取ります。

どちらの資産が `currency0` または `currency1` になるかは、プール内のトークンの並び順によって決まります。そのため、方向のパラメーターは、プールのトークンペアと合わせて解釈する必要があります。

> **トークンペアと方向の組み合わせによって、注文で提供するトークンと受け取るトークンが決まります。利用者や検証者は、意図する交換を特定するために、方向とトークンペアを合わせて確認する必要があります。**

**約定時に交換後の元本と流動性提供手数料を分離**

`_fillOrder()` 内では、フックが注文の流動性を取り除き、確定した流動性提供手数料を元本から分離します。

```solidity
BalanceDelta principalDelta = fillDelta - feesAccrued;
```

提供した通貨の元本が残っておらず、交換先の通貨の元本が負の値になっていないことを確認します。`currency0` から `currency1` への交換方向では、次のようになります。

```solidity
if (principal0 != 0 || principal1 < 0) {
    revert UnexpectedFillDelta(zeroForOne, principal0, principal1);
}
```

その後、フックは注文を約定済みとして記録し、有効な注文との対応付けを解除します。

```solidity
orderInfo.filled = true;

_setOrderId(key, tickLower, zeroForOne, ORDER_ID_DEFAULT);
```

交換後の元本が正の値の場合、その元本は、フックに帰属する `ERC-6909` 規格の請求権として記録されます。例えば、`currency1` では次のようになります。

```solidity
if (principal1 > 0) {
    poolManager.mint(address(this), key.currency1.toId(), amount1 = uint128(principal1));
}
```

これらの請求権は、引き出し時に実際のトークンを受け取るために使用されます。ソースコードには、整数の丸め処理によって、交換先の通貨の元本がゼロになる場合があると記載されています。

> **注文が約定すると、交換後の元本に対する利用者の持ち分が記録されますが、実際のトークンが利用者のウォレットへ自動的に送られるわけではありません。利用者は資産を引き出す必要があり、受取数量にはコントラクトの整数の丸め規則が適用されます。**

**完了前の取り消しでは、呼び出し元の提供分をすべて除去**

`cancelOrder()` 関数は、呼び出し元の提供分を読み取り、その注文から取り除きます。

```solidity
uint128 liquidity = orderInfo.liquidity[msg.sender];

if (liquidity == 0) revert ZeroLiquidity();

delete orderInfo.liquidity[msg.sender];

orderInfo.liquidityTotal -= liquidity;
```

取り消しのコールバックでは、その流動性をプールから取り除き、流動性提供手数料を分離して、返却される元本を指定した受取先へ移動します。

交換前であれば、元本は提供したトークンで返却されます。一部が交換されている場合は、取り消し実行時のポジションの状態に応じて、プールの両方のトークンが返却されることがあります。

取り消しでは、その有効な注文に対する呼び出し元の提供分が、すべて取り除かれます。この関数には、一部だけを取り消すための数量を指定できません。ほかの利用者に記録された提供分は、そのまま残ります。

コントラクト上では、完了前の終了に `cancelOrder()` を使用します。別の関数である `withdraw()` は、約定済みとして記録された注文に対してのみ使用されます。

> **利用者は、完全に完了する前でも注文を終了し、流動性を取り除くことで返却される元本を受け取れます。返却される元本には、両方のトークンが含まれる場合があります。この操作では、その有効な注文に対する利用者の提供分全体が取り除かれるため、未交換の残りの部分が有効なまま残ることはありません。**

**約定後の資産は呼び出し元の持ち分に応じて引き出し**

`withdraw()` 関数を使用するには、注文が約定済みとして記録されており、呼び出し元にゼロではない提供分が記録されている必要があります。

```solidity
if (!orderInfo.filled) revert NotFilled();

uint128 liquidity = orderInfo.liquidity[msg.sender];

if (liquidity == 0) revert ZeroLiquidity();

delete orderInfo.liquidity[msg.sender];
```

呼び出し元の持ち分は、その注文に残っている元本の合計と流動性を使用して計算されます。

```solidity
amount0 = FullMath.mulDiv(orderInfo.currency0Total, liquidity, liquidityTotal);
amount1 = FullMath.mulDiv(orderInfo.currency1Total, liquidity, liquidityTotal);

orderInfo.currency0Total -= amount0;
orderInfo.currency1Total -= amount1;

orderInfo.liquidityTotal -= liquidity;
```

引き出し数量の端数は切り捨てられます。ソースコードに記載されているとおり、端数は注文に残る合計数量に保持され、その後の引き出しに使用されます。

呼び出し元に記録された持ち分は、すべて消去されます。この関数には、その持ち分の一部だけを引き出すための数量を指定できません。

`currency0` の引き出し数量が正の値の場合、コールバックは対応する請求権を消却し、実際のトークンを移動します。

```solidity
if (withdrawData.currency0Amount > 0) {
    poolManager.burn(address(this), withdrawData.currency0.toId(), withdrawData.currency0Amount);
    poolManager.take(withdrawData.currency0, withdrawData.to, withdrawData.currency0Amount);
}
```

`currency1` にも、同じ仕組みが適用されます。

> **利用者の引き出し数量は、呼び出し元のウォレットに記録された提供分から計算されます。別のウォレットは、注文の識別子を知っているだけでは、その持ち分を引き出せません。この操作では、呼び出し元の持ち分全体を引き換え、計算された資産を指定した受取先へ移動します。**

**流動性提供手数料はプロトコルの資金管理先へ割り当て**

これらの注文ポジションから確定した流動性提供手数料は、すべてプロトコルの資金管理先へ割り当てられます。利用者が引き出せる元本には含まれません。

資金管理先のアドレスは、コントラクトの配置時に固定されます。

```solidity
address public immutable treasury;
```

注文配置、取り消し、約定の処理では、`_routeFeesToTreasury()` を通じて、確定した手数料を振り分けます。各呼び出しでは、請求権による振り分けを指定するために `true` を渡します。例えば、次のようになります。

```solidity
_routeFeesToTreasury(key, feesAccrued, true);
```

振り分け関数内では、`currency0` の手数料を次のように処理します。

```solidity
key.currency0.take(poolManager, treasury, amount0Fee, asClaims);
```

含まれている補助コードの `CurrencySettler` では、請求権を発行するか、実際のトークンを移動するかを、次のように切り替えています。

```solidity
claims ? poolManager.mint(recipient, currency.toId(), amount) : poolManager.take(currency, recipient, amount);
```

請求権による振り分けが有効な場合、資金管理先は `ERC-6909` 規格の請求権を受け取ります。利用者の操作中に、実際のトークンを資金管理先へ即時に移動する必要はありません。

> **利用者が引き出せる元本には、資金管理先へ割り当てられる流動性提供手数料は含まれません。両者を分離することで、利用者の注文による受取資産と、プロトコルの収益に当たる数量が明確になります。また、請求権による手数料の振り分けにより、注文配置、取り消し、約定処理の最中に、実際のトークンを資金管理先へ即時に移動する必要がなくなります。**

**コントラクトによる追加の確認**

**決済用コールバックの呼び出しをプール管理コントラクトに限定**

フックの決済用コールバックには、`onlyPoolManager` が使用されています。

```solidity
function unlockCallback(bytes calldata rawData) public virtual onlyPoolManager returns (bytes memory returnData) {
```

この修飾子は、公開されている依存コードの `BaseHook` 内で定義されています。

```solidity
modifier onlyPoolManager() {
    if (msg.sender != address(poolManager)) revert NotPoolManager();
    _;
}
```

設定されたプール管理コントラクト以外からの呼び出しは拒否されます。

> **この決済用コールバックを直接呼び出せるのは、設定されたプール管理コントラクトだけです。これにより、注文資産の配置、取り消し、引き出しに伴う決済処理を行うコールバックへのアクセスが制限されます。**

**プールの情報は、このフックを参照する必要あり**

フックは、指定されたプールキーを検証します。

```solidity
function _validatePoolKey(PoolKey calldata key) internal view {
    if (address(key.hooks) != address(this)) {
        revert InvalidPoolHook();
    }
}
```

別のフックを参照するプールキーは拒否されます。

ソースコードに記載されているとおり、この確認だけでプールの初期化が完了していることを確認するわけではありません。初期化済みのプールに必要な確認は、プール管理コントラクトの操作で実施されます。

> **別のフックを参照する注文配置や取り消しの要求は拒否されます。これにより、参照先のフックが一致しない状態で、これらの操作が進むことを防ぎます。ただし、すべてのプールやトークンが対応していることを保証するものではありません。**

**ネイティブ通貨を含むプールを拒否**

初期化の際に、フックはネイティブ通貨が含まれるかどうかを確認します。

```solidity
if (key.currency0.isAddressZero()) revert NativeCurrencyNotSupported();
```

プール内の通貨の並び順では、ネイティブ通貨が `currency0` に配置されるため、この確認によって、ネイティブ通貨を含むペアを拒否します。

また、ソースコードでは、移動時に手数料が発生するトークン、残高が自動調整されるトークン、特定のアドレスを拒否する機能や、一時停止機能を持つトークンの挙動は、対応するトークンの前提条件に含まれないとされています。これらの性質はフックによって検出・制限されないことも明記されています。

> **利用者は、このフックを使用して、ネイティブ通貨を含むプールに注文することはできません。トークンの互換性にも注意が必要です。ネイティブ通貨の確認だけで、ソースコードに非対応として挙げられたトークンの挙動を、すべて検出・拒否できるわけではありません。**

**注文の操作履歴をオンチェーンで確認**

コントラクトは、注文の操作や手数料の振り分けに関するイベントを発行します。

| イベント                 | 記録される操作                              |
| -------------------- | ------------------------------------ |
| `Place`              | 呼び出し元が注文への提供分を追加します。                 |
| `Fill`               | 有効な注文が約定済みとして記録されます。                 |
| `Cancel`             | 呼び出し元が自分の提供分を取り消します。                 |
| `Withdraw`           | 呼び出し元が約定済み注文の自分の持ち分を引き換えます。          |
| `ProtocolFeesRouted` | ゼロではない確定済みの流動性提供手数料が、資金管理先へ振り分けられます。 |

また、次の読み取り関数も提供しています。

* **`getOrderId()`** は、プール、下限ティック、方向に対応する、有効な注文の識別子を返します。
* **`getOrderInfo()`** は、約定状態、通貨、残っている元本の合計、流動性の合計を返します。
* **`getOrderLiquidity()`** は、指定したアドレスに記録されている提供分を返します。
* **`getTickLowerLast()`** は、そのプールで最後に記録された下限ティックを返します。

例えば、次のようになります。

```solidity
function getOrderLiquidity(OrderIdLibrary.OrderId orderId, address owner) external view returns (uint256) {
    return _orderInfos[orderId].liquidity[owner];
}
```

> **利用者は、操作画面に表示される注文状態を、コントラクトの記録や取引イベントと照合できます。これにより、自分の提供分や、注文配置、約定、取り消し、引き出し、手数料の振り分けに関する履歴を、独立した方法で確認できます。**

## ソースコードを公開する意義

マルチシグアカウントの監査と、公開されている `LimitOrderHook` のソースコードは、それぞれ異なる形で検証を可能にします。監査には、指定されたマルチシグのコードに対する独立した検証が記録されています。一方、公開されたフックのソースコードでは、注文処理を直接確認できます。

公開コードにより、検証者は、指値注文機能を支える次のような実装を確認できます。

* プール内の操作に対して有効になっている、フックのコールバック。
* 注文資産の提供と決済の方法。
* 各アドレスの提供分を記録する方法。
* ティック範囲と交換方向の表現方法。
* プールでのスワップ後に約定を処理する方法。
* 取り消しと引き出しの違い。
* 元本、端数処理、流動性提供手数料の計算・記録方法。
* 適用されるアクセス確認と、トークンに関する前提条件。

ベーススキャンでは、公開されたコントラクトのソースコードが、配置済みのバイトコードと完全に一致することが示されています。フックリストの提出情報には、フックの説明と配置先アドレスが別途記載されています。ソースコードの一致検証も、フックリストへの提出も、セキュリティ監査ではありません。

> **利用者は、機能の説明と実際の実装を比較したり、技術的な検証者に確認を依頼したりできます。これにより、公開されたルールに基づいて、注文と関連資産がどのように扱われるかを評価できます。**

## 透明性を通じた安全性の確認

公開されているフックと依存コードにより、開発者やセキュリティの専門家は、注文資産、提供分、約定、取り消し、引き出し、手数料の処理方法を確認できます。これとは別に、ブロックセックの報告書には、指定されたマルチシグアカウントのコントラクトに対する検証内容が記載されています。

ソースコードの公開は、第三者による独立した検証を可能にします。ただし、公開されていることだけで、安全性や正常な実行が保証されるわけではありません。

> **利用者は、公開された指値注文の実装を確認し、マルチシグアカウントの独立した監査報告書を参照できます。それぞれの資料には明確な対象範囲があり、該当する機能について、情報に基づいた評価を行うために役立ちます。**

## 接続方法

現在、キーリング・ワンへの接続には、キーリング・プロ・ウォレットのみ対応しています。以下の接続手順を行うには、キーリング・プロ・ウォレットが必要です。

**キーリング・プロ・ウォレットのダウンロード**

以下の二次元コードから、アイオーエス版およびアンドロイド版のキーリング・プロ・ウォレットをダウンロードできます。

**アイオーエス版**

![アイオーエス版キーリング・プロ・ウォレットのダウンロード用二次元コード](https://357078050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGG08yVdyf2Am7Dz4fIrs%2Fuploads%2FJeCfQNYVDZNPoCKBtNKO%2FKEYRING%20QR%20iOS.png?alt=media\&token=2dd7506b-e6c0-4e68-b510-c4b0fe2aab7b)

**アンドロイド版**

![アンドロイド版キーリング・プロ・ウォレットのダウンロード用二次元コード](https://357078050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGG08yVdyf2Am7Dz4fIrs%2Fuploads%2FFA84eeaOYfsgKkSoDLSl%2FKEYRING%20QR%20Android.png?alt=media\&token=7d45ae63-2677-4563-bd18-d4fe2b539e77)

#### **キーリング・ワンへの接続**

1. キーリング・ワンの画面右上にある「ウォレットを接続」を選択します。
2. 「ウォレットを接続」画面で「次へ」を選択します。
3. ウォレットコネクトの二次元コードが表示されます。
4. キーリング・プロ・ウォレットのアプリを開きます。
5. 接続するアカウントを選択します。
6. 「ウォレットコネクト」を選択します。
7. キーリング・ワンに表示された二次元コードを読み取ります。
8. 「アドレスの確認」の要求が表示されたら、「確認」を選択します。
9. キーリング・プロ・ウォレットに認証要求が表示されます。
10. 認証要求に署名して、接続を完了します。

![キーリング・プロ・ウォレットからキーリング・ワンへの接続手順](https://357078050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGG08yVdyf2Am7Dz4fIrs%2Fuploads%2FsheEBFE8sRrbLZ0iX6gh%2FHow-to-connect-gif.gif?alt=media\&token=3e2ad75a-419a-4c4d-8ffa-1fcf11793d1b)
