指定した最低金額以上の送金を監視する方法
監視で1つのアセットに最低金額を設定する手順。基礎単位、境界値を含む条件、人工データによる確認を説明します。
更新日:
監視では、指定した金額以上の送金を追跡できます。選択したプロジェクトのアドレスで、「詳細フィルター」の「最小限の金額」を設定してください。しきい値は、選択したアセットの最小単位で表す整数です。境界値を含む条件なので、金額がしきい値と同じ送金は対象となり、それより小さい送金は対象になりません。
まずは1つのネットワークで1つのアセットから始めてください。たとえば、特定のトークンが自分のアドレスに入ってくる送金を監視する場合です。これは個々の送金額に対するルールであり、ドル価格、1日の入金総額、外部プロバイダーからのメッセージの設定ではありません。
アセットと単位を準備する
「監視」サービスが利用できるプロジェクト、公開アドレス、その設定を変更する権限を用意します。必要なネットワークが実際の監視に利用できることを確認してください。公開アドレスの追加に秘密鍵やリカバリーフレーズは必要ありません。
正確なアセットとその小数桁数を確認してください。トークン名だけでは不十分で、ネットワークと識別子が選択した監視方法に一致する必要があります。USDTを受け取る場合も、異なるネットワークや似たトークンを同一のアセットとして扱わないでください。選び方は「ネットワークとトークンの違い」で説明しています。
人が読む形式の金額を基礎単位に変換するには、アセットの小数桁数を指数とする10の累乗を掛けます。丸めたドル換算額を使わないでください。小数点以下が六桁のアセットでは、10単位のしきい値を10000000と入力します。これは桁の尺度を示す例で、すべてのコインに共通のしきい値ではありません。
ステップ1. アドレス追加画面を開く
「監視」を開き、プロジェクトと「アドレス」セクションを選びます。「アドレスを追加します」を押してください。「手動」タブでネットワークを選び、公開アドレスを入力します。形式チェックの結果を待ちますが、アドレスの所有関係と接続の準備状況は別途確認してください。
アドレスの用途を選ぶ欄で「1つのアセット」を選択します。ネットワークのネイティブコインなら「アセット」欄は空のままにし、トークンなら選択したネットワークで対応している識別子を入力してください。この例では「受信」を有効にしておきます。送信側の送金も必要なら、その対応状況と方向設定を別途確認してください。
最初のルールでいきなりすべてのアセットを選ばないでください。最小単位が異なれば、同じ数値のしきい値でも経済的に同じ金額にはなりません。ネットワークとアセットの組み合わせを絞ることで、尺度を混同せずに計算を確認できます。
ステップ2. 最低金額を設定する
「詳細フィルター」を展開します。「ベースネットワークユニット」と案内されている「最小限の金額」欄に、計算した整数を入力してください。上記の尺度なら10000000です。この値はmin_amountパラメーターに対応します。
ここには小数、コインの記号、通貨記号、桁区切りを入力しないでください。空欄は、個別の最低金額を設定していないことを意味します。入力した数値がドルから自動換算されたり、相場に合わせて調整されたりすることはありません。
「最小限の確認」は別の条件です。金額の誤りを補うために変更しないでください。しきい値は、評価する個々の送金ごとに確認されます。小さな入金を複数回受けても、自動的に合算されて条件を満たす1回の支払いになるわけではありません。
ステップ3. ルールを保存して確認する
「アドレスを追加します」を押し、アカウントでセキュリティチェックを求められた場合は、表示された手順を完了してください。保存後にアドレスを開き、対象プロジェクトのルールを探して、アセット、方向、保存された最低金額を確認します。接続が有効になっていることも確認してください。数値の入力に成功しただけでは、それを証明できません。
1つのアドレスを複数のプロジェクトで使っている場合は、選択したルールを確認してください。別のプロジェクトには異なるしきい値があり、異なるイベントを受け取ることがあります。別のプロジェクトに送金が表示されても、自分の最低金額が無視されたとは限りません。
ステップ4. 実際の送金をせずに境界値を確認する
しきい値が10000000の場合、最小単位で期待される結果は次のとおりです。
| 送金額 | 金額の判定 |
|---|---|
| 9999999 | しきい値未満のため対象外 |
| 10000000 | しきい値と等しいため対象 |
| 10000001 | しきい値を超えるため対象 |
用意した人工データを使い、連携システムのローカルな検証でこれらのケースを確認してください。すべての例でネットワーク、アセット、アドレス、方向が一致している必要があります。異なっていれば、別の条件を検証していることになります。フィルターの算術を確かめるために暗号資産を送る必要はありません。この境界値の検証だけでは、選んだ受信者への通知配信までは確認できません。通知の経路は別途確認してください。
期待した結果と異なる場合
まず最小単位と尺度を比較し、その後にアセット、方向、プロジェクト、ルールが有効かどうかを確認します。表示通貨での現在の評価額ではなく、実際の送金額を確認してください。記録の調査にはTXIDが役立ちます。監視のイベントが発生しただけでは、注文の支払いは確認できません。請求書との対応付けと、その状態の確認が必要です。