0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

AIが書いた暗号資産の計算コードをレビューする:Decimal・通貨単位・境界値の確認

0
Posted at

AIに「暗号資産の購入金額を計算するPythonコードを書いて」と頼むと、数行で動くコードが返ってきます。

ただし、実行できることと、計算の前提が正しいことは別です。金額を扱うコードでは、型だけでなく、通貨単位や手数料の扱いまで確認する必要があります。

この記事では、単純な現物購入の計算を例に、AI生成コードをレビューするときのポイントを整理します。

1. 計算式を書く前に、単位を決める

今回は次のモデルに限定します。

  • 価格:1 BTCあたりのUSDT
  • 数量:購入するBTCの数量
  • 手数料:USDTで別途支払う金額
  • 求める値:購入に必要なUSDTの合計

この条件なら、計算式は次のようになります。

購入金額 = 価格 × 数量 + 手数料

例えば、価格が60,000 USDT、数量が0.001 BTC、手数料が0.06 USDTなら、合計は60.06 USDTです。

ただし、手数料がBTC建てなら、そのままUSDTの金額に足すことはできません。

BYDFiなどの取引所データを扱う場合も、最初に確認したいのは各項目の単位です。価格の通貨、数量の通貨、手数料の通貨を別々に確認します。以下は説明用の独自形式であり、特定サービスのCSVやAPI仕様を再現したものではありません。

2. Decimalには文字列から値を渡す

Pythonのfloatでは、多くの十進小数を厳密に表現できません。

print(0.1 + 0.2)
# 0.30000000000000004

十進数として計算したい場合は、標準ライブラリのDecimalが選択肢になります。

from decimal import Decimal

print(Decimal("0.1") + Decimal("0.2"))
# 0.3

ここで大切なのは、Decimal(0.1)ではなく、Decimal("0.1")とすることです。

先にfloatへ変換すると、その時点の近似値を引き継ぐ可能性があります。CSVの文字列を読み取る場合も、途中でfloatを経由させないようにします。

3. 計算できない入力は明示的に止める

次の関数では、数値を文字列で受け取り、通貨の不一致や不正な値を拒否します。

from decimal import Decimal, localcontext


def purchase_cost(price, quantity, fee, *, quote, fee_currency):
    if not all(isinstance(v, str) for v in (price, quantity, fee)):
        raise TypeError("Pass decimal values as strings")

    p, q, f = map(Decimal, (price, quantity, fee))

    if not all(v.is_finite() for v in (p, q, f)):
        raise ValueError("Values must be finite")

    if p <= 0 or q <= 0 or f < 0:
        raise ValueError("Require price > 0, quantity > 0, fee >= 0")

    if fee_currency != quote:
        raise ValueError("Convert the fee to quote currency first")

    with localcontext() as ctx:
        ctx.prec = 40
        return p * q + f


result = purchase_cost(
    "60000",
    "0.001",
    "0.06",
    quote="USDT",
    fee_currency="USDT",
)

print(result)
# 60.060

60.060と60.06は、数値としては同じです。表示桁数の調整と計算処理は分けて考えます。

また、Decimalも無制限の精度を保証するものではありません。この例では有効桁数を40に設定していますが、実際の入力範囲に合わせた設計が必要です。

4. 正常系以外の入力も確認する

レビューでは、期待する結果が出る例だけでなく、受け入れるべきでない入力も試します。

入力条件 この関数の期待動作
60,000 × 0.001 + 0.06 60.06になる
0.1 × 0.2、手数料ゼロ 0.02になる
価格がNaN 拒否する
数量がゼロ 拒否する
手数料が負数 拒否する
USDTの購入額にBTCの手数料を加える 拒否する
数値をfloatで渡す 拒否する

このサンプルでは、上記7ケースをPython 3.14.3で確認しています。

例えば、正常系は次のように検証できます。前のコードと同じファイルに追加して実行します。

assert purchase_cost(
    "60000",
    "0.001",
    "0.06",
    quote="USDT",
    fee_currency="USDT",
) == Decimal("60.06")

assert purchase_cost(
    "0.1",
    "0.2",
    "0",
    quote="USDT",
    fee_currency="USDT",
) == Decimal("0.02")

なお、負の手数料を拒否するのは、このモデルがリベートを扱わないためです。返金や手数料還元を扱うなら、仕様とテストを追加する必要があります。

また、数値として解釈できない文字列を渡した場合は、Decimalの変換時にInvalidOperationが発生します。実際のアプリケーションでは、入力エラーをどこで捕捉し、利用者にどう伝えるかも設計します。

5. この計算だけでは扱えないもの

実際の取引記録を処理する場合は、さらに確認する項目があります。

  • 手数料が購入した資産から差し引かれる場合
  • 注文が複数の価格で約定する場合
  • 取引所が適用する数量・金額の丸め規則
  • 手数料を別通貨で支払う場合の換算方法

この関数が求めるのは、限定した条件での購入金額です。損益計算、税務上の取得価額、先物の証拠金計算には、そのまま使用できません。

AIにコードを依頼するときも、「金額を計算して」だけで終わらせず、入力の単位、許容する値、対象外のケースまで伝えると、レビューすべき点が明確になります。

短い計算コードほど、式の外側にある前提を確認しておきたいところです。

関連記事

AIによるコード変更を検証するというテーマでは、次の記事も参考になります。本記事のサンプルコードは独立した例です。

Claude Code のコミット前フックで TruffleHog を実行し、シークレット入りのコミットを止める

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?