Submit a background lookup job
walletlink_submit_jobSubmit a list of addresses as a background job. A job runs a deeper scan than the resolve tool: an address the index has not checked, or holds only stale answers for, is resolved against live sources, so a job can find identities the resolve tool reports as never seen. Use it for lists larger than one resolve call, or when misses are worth re-checking.
COST: billed on matches exactly like resolving, when the job completes: one match credit per address that resolved to an X handle or a Farcaster account, misses free. One job may be active per account at a time; a second submission is refused until the first finishes, and the refusal names the active job id. A submission is capped at 10 times the match balance, so the worst case is bounded by what the account already holds. Submitting itself spends one request-unit of the rate window.
The submission returns a job id. Poll walletlink_job_status for progress and, on completion, the results. A job that fails is never billed.
Resubmitting the same list after a job completes runs the whole job again and bills its matches again.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addresses | Yes | Ethereum addresses, each 0x followed by 40 hex characters. Case does not matter. The ceiling is the balance-derived cap, not a fixed number; a list over the cap is refused with the cap named. |