Authorize a worker on your site (step 1 of 2)
prepare_site_authorizationSome jobs, like the credentialed construction-safety jobs in Los Angeles, are open only to a worker whose credential a person has checked AND whom the site itself has authorized. This is how the site says so. You are the contractor that posted the job, or a wallet that contractor named as its acceptor, and you sign that ONE worker wallet may be on your site for THIS job. FREE, a signed statement, no fee, no gas, no money moves. It holds for that wallet on that job alone, never for another job or another person, and you can withdraw it the same way (pass revoke true). The house, the worker, a stranger and a payer who only pays for the job and accepts its proof are refused here, and nothing is signed for them: the signer must be the poster or the wallet the poster named. A job that needs a permit stays closed whatever you sign, and it does not check the worker's credential, which the worker records themselves. Never put a phone number, an email or an address in the note. Returns MESSAGE_TO_SIGN and BODY_JSON; sign with the authorizer wallet's personal_sign, then call submit_site_authorization within 5 minutes. Cost and signer: free, no gas; the person signs the result with their own wallet or passkey, and the house never holds a key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workId": "<workId>",
"authorizerWallet": "<authorizerWallet>",
"workerWallet": "<workerWallet>"
},
"name": "prepare_site_authorization"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Optional, up to 200 characters: one plain sentence for your own record. Never a phone number, an email or an address. | |
| revoke | No | Pass true to withdraw this worker's authorization on this job. Leave out to give it. | |
| workId | Yes | The packet id of the job the worker will do on your site. | |
| workerWallet | Yes | The 0x… address of the one worker you are authorizing. The worker gives you this. Address only, never a private key. | |
| authorizerWallet | Yes | The 0x… address that signs: the wallet that posted the job, or the acceptor its poster named. Address only, never a private key. |
Output 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 |