X402.Scheme.EVM (X402 v0.6.0)

Shared local pre-checks for EVM authorization-style scheme payloads.

Used by the built-in X402.Scheme.ExactEVM and X402.Scheme.UptoEVM schemes to implement X402.Scheme.precheck/3, and reusable by third-party EVM scheme modules whose payloads carry an EIP-3009-style payload.authorization object.

The checks mirror the first checks every reference facilitator performs (payTo equality, exact amount equality, time window), so junk traffic is rejected without paying a facilitator verify call. Payloads without a payload.authorization map — other payload shapes, Permit2 — are skipped entirely, as is any individual absent field: the facilitator remains the authority, these checks only fail fast on certain mismatch.

Summary

Types

precheck_failure()

Reasons an authorization pre-check fails.

Functions

authorization_precheck(payload, requirements, opts \\ [])

Runs cheap local checks on an EIP-3009-style payload.authorization.

time_buffer_seconds()

Returns the settlement buffer applied to validBefore, in seconds.

Types

precheck_failure()

@type precheck_failure() ::
  :pay_to_mismatch
  | :amount_mismatch
  | :invalid_authorization_value
  | :authorization_not_yet_valid
  | :authorization_expired
  | :invalid_authorization_timing

Reasons an authorization pre-check fails.

Functions

authorization_precheck(payload, requirements, opts \\ [])

(since 0.6.0)

@spec authorization_precheck(map(), map(), keyword()) ::
  :ok | {:error, {:precheck_failed, precheck_failure()}}

Runs cheap local checks on an EIP-3009-style payload.authorization.

Checks, in order: the authorization's to must equal the requirements' payTo (case-insensitive for hex addresses); with enforce_exact_amount: true the authorization's value must equal the requirements' amount; and the validAfter/validBefore window must cover now (with a 6s settlement buffer on validBefore). Payloads without a payload.authorization map pass with :ok, as does any individual absent field.

Options

:enforce_exact_amount (default false) — require authorization.value to equal the requirements' amount exactly. Use for exact-style schemes; for ceiling schemes such as upto, the signed value is a maximum, not the settled amount.

Examples

iex> X402.Scheme.EVM.authorization_precheck(%{"payload" => %{}}, %{})
:ok

iex> payload = %{
...>   "payload" => %{"authorization" => %{"to" => "0xAb", "value" => "10"}}
...> }
iex> requirements = %{"payTo" => "0xab", "amount" => "10"}
iex> X402.Scheme.EVM.authorization_precheck(payload, requirements,
...>   enforce_exact_amount: true
...> )
:ok

iex> payload = %{
...>   "payload" => %{"authorization" => %{"to" => "0xother", "value" => "10"}}
...> }
iex> X402.Scheme.EVM.authorization_precheck(payload, %{"payTo" => "0xab"})
{:error, {:precheck_failed, :pay_to_mismatch}}

time_buffer_seconds()

(since 0.6.0)

@spec time_buffer_seconds() :: pos_integer()

Returns the settlement buffer applied to validBefore, in seconds.

Examples

iex> X402.Scheme.EVM.time_buffer_seconds()
6