指定した最低金額以上の送金を監視する方法

監視で1つのアセットに最低金額を設定する手順。基礎単位、境界値を含む条件、人工データによる確認を説明します。

更新日:

監視では、指定した金額以上の送金を追跡できます。選択したプロジェクトのアドレスで、「詳細フィルター」の「最小限の金額」を設定してください。しきい値は、選択したアセットの最小単位で表す整数です。境界値を含む条件なので、金額がしきい値と同じ送金は対象となり、それより小さい送金は対象になりません。

まずは1つのネットワークで1つのアセットから始めてください。たとえば、特定のトークンが自分のアドレスに入ってくる送金を監視する場合です。これは個々の送金額に対するルールであり、ドル価格、1日の入金総額、外部プロバイダーからのメッセージの設定ではありません。

アセットと単位を準備する

「監視」サービスが利用できるプロジェクト、公開アドレス、その設定を変更する権限を用意します。必要なネットワークが実際の監視に利用できることを確認してください。公開アドレスの追加に秘密鍵やリカバリーフレーズは必要ありません。

正確なアセットとその小数桁数を確認してください。トークン名だけでは不十分で、ネットワークと識別子が選択した監視方法に一致する必要があります。USDTを受け取る場合も、異なるネットワークや似たトークンを同一のアセットとして扱わないでください。選び方は「ネットワークとトークンの違い」で説明しています。

人が読む形式の金額を基礎単位に変換するには、アセットの小数桁数を指数とする10の累乗を掛けます。丸めたドル換算額を使わないでください。小数点以下が六桁のアセットでは、10単位のしきい値を10000000と入力します。これは桁の尺度を示す例で、すべてのコインに共通のしきい値ではありません。

ステップ1. アドレス追加画面を開く

「監視」を開き、プロジェクトと「アドレス」セクションを選びます。「アドレスを追加します」を押してください。「手動」タブでネットワークを選び、公開アドレスを入力します。形式チェックの結果を待ちますが、アドレスの所有関係と接続の準備状況は別途確認してください。

アドレスの用途を選ぶ欄で「1つのアセット」を選択します。ネットワークのネイティブコインなら「アセット」欄は空のままにし、トークンなら選択したネットワークで対応している識別子を入力してください。この例では「受信」を有効にしておきます。送信側の送金も必要なら、その対応状況と方向設定を別途確認してください。

最初のルールでいきなりすべてのアセットを選ばないでください。最小単位が異なれば、同じ数値のしきい値でも経済的に同じ金額にはなりません。ネットワークとアセットの組み合わせを絞ることで、尺度を混同せずに計算を確認できます。

ステップ2. 最低金額を設定する

「詳細フィルター」を展開します。「ベースネットワークユニット」と案内されている「最小限の金額」欄に、計算した整数を入力してください。上記の尺度なら10000000です。この値はmin_amountパラメーターに対応します。

ここには小数、コインの記号、通貨記号、桁区切りを入力しないでください。空欄は、個別の最低金額を設定していないことを意味します。入力した数値がドルから自動換算されたり、相場に合わせて調整されたりすることはありません。

「最小限の確認」は別の条件です。金額の誤りを補うために変更しないでください。しきい値は、評価する個々の送金ごとに確認されます。小さな入金を複数回受けても、自動的に合算されて条件を満たす1回の支払いになるわけではありません。

ステップ3. ルールを保存して確認する

「アドレスを追加します」を押し、アカウントでセキュリティチェックを求められた場合は、表示された手順を完了してください。保存後にアドレスを開き、対象プロジェクトのルールを探して、アセット、方向、保存された最低金額を確認します。接続が有効になっていることも確認してください。数値の入力に成功しただけでは、それを証明できません。

1つのアドレスを複数のプロジェクトで使っている場合は、選択したルールを確認してください。別のプロジェクトには異なるしきい値があり、異なるイベントを受け取ることがあります。別のプロジェクトに送金が表示されても、自分の最低金額が無視されたとは限りません。

ステップ4. 実際の送金をせずに境界値を確認する

しきい値が10000000の場合、最小単位で期待される結果は次のとおりです。

送金額 金額の判定
9999999 しきい値未満のため対象外
10000000 しきい値と等しいため対象
10000001 しきい値を超えるため対象

用意した人工データを使い、連携システムのローカルな検証でこれらのケースを確認してください。すべての例でネットワーク、アセット、アドレス、方向が一致している必要があります。異なっていれば、別の条件を検証していることになります。フィルターの算術を確かめるために暗号資産を送る必要はありません。この境界値の検証だけでは、選んだ受信者への通知配信までは確認できません。通知の経路は別途確認してください。

期待した結果と異なる場合

まず最小単位と尺度を比較し、その後にアセット、方向、プロジェクト、ルールが有効かどうかを確認します。表示通貨での現在の評価額ではなく、実際の送金額を確認してください。記録の調査にはTXIDが役立ちます。監視のイベントが発生しただけでは、注文の支払いは確認できません。請求書との対応付けと、その状態の確認が必要です。