Ask for real work at a place (prepare signed request)
prepare_requestRead-onlyIdempotent
Prepare an attributable request for an existing work packet, a canonical definition, or a specific objective. Unlike posting a new packet, this asks the existing /labor/request bridge to resolve the need to one governed packet or an explicit blocker. Your own wallet signs the exact MESSAGE_TO_SIGN locally; never provide a private key. Set requesterKind=agent only when an agent is the genuine requester; do not relabel a human request as agent demand. Optional lat/lng must come explicitly from an entitled caller, never inferred from device or host location. A request does NOT fund a job, hire anyone, grant site access, or certify an ecological outcome. It is free when the signed waiver lane is enabled. Check the real gate's response.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Optional real latitude from the requester, never inferred; give with lng to locate the objective. | |
| lng | No | Optional real longitude from the requester, never inferred; give with lat. | |
| note | No | Optional public context, at most 280 characters. No secrets, names or contact details. | |
| workId | No | Request an existing posted packet by its workId. Mutually exclusive with definitionId and objective. | |
| objective | No | Describe the needed outcome in 5-300 characters. Mutually exclusive with workId and definitionId. | |
| definitionId | No | Request existing documented work that may not have a posting yet. Mutually exclusive with workId and objective. | |
| requesterKind | Yes | Who actually requests the work. Use agent only for true agent-originated demand. | |
| requesterWallet | Yes | 0x address the requester controls and will sign with. Never submit a private key. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| tool | No | ||
| funded | No | ||
| payUsd | No | ||
| workId | No | ||
| claimId | No | ||
| claimable | No | ||
| next_call | No | ||
| proofRule | No | ||
| fulfillableBy | No | ||
| definitionOfDone | No | ||
| needs_from_caller | No | ||
| notClaimableReason | No |