find_work

Search Vealth's public board of real ecological and community work packets. Each result includes the pay, the skill level, the exact proof that gets it approved, and a page URL. Free, no account, no wallet. Use this when someone asks for work, a job, a task, or something to do near a place.

Parameters6

query	string	optional	Free text, e.g. 'storm drain' or 'tree planting'. Typo-tolerant.
latitude	number	optional	Center of the search.
longitude	number	optional	Center of the search.
radiusKm	number	optional	Search radius in km. Default 50.
skillLevel	string	optional	Use 'entry' for someone starting today.
limit	number	optional	Max results, 1-25. Default 10.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text, e.g. 'storm drain' or 'tree planting'. Typo-tolerant."
    },
    "latitude": {
      "type": "number",
      "description": "Center of the search."
    },
    "longitude": {
      "type": "number",
      "description": "Center of the search."
    },
    "radiusKm": {
      "type": "number",
      "description": "Search radius in km. Default 50."
    },
    "skillLevel": {
      "type": "string",
      "enum": [
        "entry",
        "intermediate",
        "advanced"
      ],
      "description": "Use 'entry' for someone starting today."
    },
    "limit": {
      "type": "number",
      "description": "Max results, 1-25. Default 10."
    }
  }
}

get_work_packet

Full detail for a single packet by its id, including the full description and proof requirement.

Parameters1

workId

string

required

e.g. WORK_1784530149768_4z4r6jz

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "e.g. WORK_1784530149768_4z4r6jz"
    }
  },
  "required": [
    "workId"
  ]
}

how_to_claim

Explains exactly how to claim work and what happens after. Claiming is free. Returns instructions, never performs the claim, because claiming requires the worker's own wallet signature.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

estimate_footprint

The anchor tool. Give a rough token or call count for your AI session and get an order-of-magnitude CO2e estimate PLUS the real, verifiable ecological work you can provision to answer it on Vealth. Vealth does NOT sell paper offsets — it provisions maintenance of the commons: you fund a bounded work packet keyless from your own wallet, an approved proof retires carbon, and you receive an on-chain retirement certificate that compounds. Call find_work next to pick the work. The estimate is orientation only, never a precise carbon claim, and this server never takes payment or holds a wallet.

Parameters2

tokens	number	optional	Approx total tokens this session (input + output).
calls	number	optional	Or approx number of model calls, if you have no token count.

Raw schema

{
  "type": "object",
  "properties": {
    "tokens": {
      "type": "number",
      "description": "Approx total tokens this session (input + output)."
    },
    "calls": {
      "type": "number",
      "description": "Or approx number of model calls, if you have no token count."
    }
  }
}

provision_work

Turn a place + problem (or a board packet id) into provisioned work: a bounded packet with scope, standards-registered method, proof requirement, tCO2e estimate, and the keyless funding path YOU pay from your own wallet. This tool returns the packet and the path; it never spends, never holds funds, never signs. Approved proof retires carbon and issues an on-chain certificate — provision, not offset.

Parameters5

workId	string	optional	Provision a specific open board packet by id (from find_work).
query	string	optional	Or free text for the problem, e.g. 'storm drain' or 'tree planting'.
latitude	number	optional	Center of the search, with query.
longitude	number	optional	Center of the search, with query.
radiusKm	number	optional	Search radius in km. Default 50.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "Provision a specific open board packet by id (from find_work)."
    },
    "query": {
      "type": "string",
      "description": "Or free text for the problem, e.g. 'storm drain' or 'tree planting'."
    },
    "latitude": {
      "type": "number",
      "description": "Center of the search, with query."
    },
    "longitude": {
      "type": "number",
      "description": "Center of the search, with query."
    },
    "radiusKm": {
      "type": "number",
      "description": "Search radius in km. Default 50."
    }
  }
}

retire_and_certify

How to retire a given tCO2e amount for real, on-chain, via the Klima rail — paid keyless from the caller's own wallet, returning a confirmed retire transaction as the certificate. Returns instructions and the exact door; this server never performs the retirement and never holds a wallet. The retirement is real; any footprint number behind it stays orientation, never a precise carbon claim.

Parameters3

amount_tco2e	number	required	Tonnes of CO2e to retire, e.g. 0.005.
beneficiary_name	string	optional	Optional name to record on the retirement.
retirement_message	string	optional	Optional message to record on the retirement.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_tco2e": {
      "type": "number",
      "description": "Tonnes of CO2e to retire, e.g. 0.005."
    },
    "beneficiary_name": {
      "type": "string",
      "description": "Optional name to record on the retirement."
    },
    "retirement_message": {
      "type": "string",
      "description": "Optional message to record on the retirement."
    }
  },
  "required": [
    "amount_tco2e"
  ]
}

verify_work

Check a proof URI is safely machine-checkable, then get the exact path to Vealth's paid verification door: a SIGNED, re-checkable certificate anyone can reproduce — no oracle, no judge. Digital claims only; physical proof (photo + GPS + signature) is honestly routed to human review, never faked. This tool validates and instructs; the caller pays the door from their own wallet.

Parameters4

proofUri	string	required	https URL of the LIVE proof to verify. No auth, no query parameters.
workId	string	optional	Optional board packet id, to check its specific proof requirement.
standard	string	optional	Optional standard key the claim is made against.
definitionId	string	optional	Optional self-verifying definition id, if known.

Raw schema

{
  "type": "object",
  "properties": {
    "proofUri": {
      "type": "string",
      "description": "https URL of the LIVE proof to verify. No auth, no query parameters."
    },
    "workId": {
      "type": "string",
      "description": "Optional board packet id, to check its specific proof requirement."
    },
    "standard": {
      "type": "string",
      "description": "Optional standard key the claim is made against."
    },
    "definitionId": {
      "type": "string",
      "description": "Optional self-verifying definition id, if known."
    }
  },
  "required": [
    "proofUri"
  ]
}

anchor_proof

Anchor the SHA-256 of any file onchain, free. Use it the moment you produce something whose PRIORITY matters: a security finding before you disclose it, research before you share it, a draft before you send it out. You send only the hash, never the file, so nothing you make is disclosed to anyone. It lands in the next weekly Base batch and the Ethereum root, and from then on anyone can prove those exact bytes existed by that time. Free to submit, free to verify, no account, no wallet, no payment.

Parameters2

sha256	string	required	SHA-256 of your file, 64 lowercase hex characters. Get it with: shasum -a 256 <file>
label	string	optional	Optional short public label for your own reference. Never include anything secret.

Raw schema

{
  "type": "object",
  "properties": {
    "sha256": {
      "type": "string",
      "description": "SHA-256 of your file, 64 lowercase hex characters. Get it with: shasum -a 256 <file>"
    },
    "label": {
      "type": "string",
      "description": "Optional short public label for your own reference. Never include anything secret."
    }
  },
  "required": [
    "sha256"
  ]
}

verify_anchor

Given the SHA-256 of a file, say whether it is anchored, when, and return the merkle proof plus the transaction so the caller can check it independently without trusting Vealth. Use it to confirm someone held a document when they claim they did, or to confirm your own submission landed. Free and keyless.

Parameters1

sha256

string

required

SHA-256 of the file, 64 lowercase hex characters.

Raw schema

{
  "type": "object",
  "properties": {
    "sha256": {
      "type": "string",
      "description": "SHA-256 of the file, 64 lowercase hex characters."
    }
  },
  "required": [
    "sha256"
  ]
}

board_stats

Live counts from the Vealth work board, read at this moment — total and open work, claims, settlements, proposed value, and the sector breakdown. Pass a location to also count work nearby. Never cached; the public mirror is https://vealth.net/labor/stats. Free, keyless, read-only.

Parameters3

latitude	number	optional	Optional: also count open work near this point.
longitude	number	optional	Optional: also count open work near this point.
radiusKm	number	optional	Nearby radius in km. Default 50.

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "description": "Optional: also count open work near this point."
    },
    "longitude": {
      "type": "number",
      "description": "Optional: also count open work near this point."
    },
    "radiusKm": {
      "type": "number",
      "description": "Nearby radius in km. Default 50."
    }
  }
}

prepare_claim

Start claiming a packet for a wallet you control. Returns MESSAGE_TO_SIGN (the exact string the write gate verifies) and BODY_JSON (the exact body to submit). Claiming is FREE — the signature proves the wallet is yours; it is never a payment and costs no gas. Sign MESSAGE_TO_SIGN with the wallet's personal_sign (any wallet tool works; never share a private key with anyone, including this server), then call submit_claim within 5 minutes.

Parameters2

workId	string	required	The packet id, from find_work.
workerWallet	string	required	The 0x… address that will sign and own this claim.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "The packet id, from find_work."
    },
    "workerWallet": {
      "type": "string",
      "description": "The 0x… address that will sign and own this claim."
    }
  },
  "required": [
    "workId",
    "workerWallet"
  ]
}

submit_claim

Complete the claim: pass the BODY_JSON string from prepare_claim UNCHANGED plus the signature your wallet produced over MESSAGE_TO_SIGN. This server relays the signed request to the same public claim gate any HTTP client uses — it holds no keys and no funds, and without your signature it can do nothing. Success returns your claimId; keep it, proof submission needs it.

Parameters2

bodyJson	string	required	The exact BODY_JSON string from prepare_claim, unchanged.
signature	string	required	The 0x… personal_sign output over MESSAGE_TO_SIGN.

Raw schema

{
  "type": "object",
  "properties": {
    "bodyJson": {
      "type": "string",
      "description": "The exact BODY_JSON string from prepare_claim, unchanged."
    },
    "signature": {
      "type": "string",
      "description": "The 0x… personal_sign output over MESSAGE_TO_SIGN."
    }
  },
  "required": [
    "bodyJson",
    "signature"
  ]
}

prepare_proof

You did the work — start handing in proof. Pass the packet's workId, your claimId (from submit_claim), your wallet, and proof items matching the packet's own proof line (photos with GPS for field work; documents/text for digital work). Returns MESSAGE_TO_SIGN and BODY_JSON. Submitting proof is FREE when signed — a worker is never charged at the moment they have earned the right to be asked for nothing. Sign, then call submit_proof within 5 minutes.

Parameters5

workId	string	required	The packet id.
claimId	string	required	Returned by submit_claim.
workerWallet	string	required	The same 0x… address that claimed.
proofs	array	required	1-20 proof items, e.g. {"type":"photo","uri":"https://…","capturedAt":"<ISO>","lat":…,"lng":…}. The packet's proof line (get_work_packet) says exactly what it needs.
gps	object	optional	For geolocated field work: {lat, lng} captured ON SITE — the gate refuses geolocated proof without it.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "The packet id."
    },
    "claimId": {
      "type": "string",
      "description": "Returned by submit_claim."
    },
    "workerWallet": {
      "type": "string",
      "description": "The same 0x… address that claimed."
    },
    "proofs": {
      "type": "array",
      "description": "1-20 proof items, e.g. {\"type\":\"photo\",\"uri\":\"https://…\",\"capturedAt\":\"<ISO>\",\"lat\":…,\"lng\":…}. The packet's proof line (get_work_packet) says exactly what it needs.",
      "items": {
        "type": "object"
      }
    },
    "gps": {
      "type": "object",
      "description": "For geolocated field work: {lat, lng} captured ON SITE — the gate refuses geolocated proof without it.",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        }
      }
    }
  },
  "required": [
    "workId",
    "claimId",
    "workerWallet",
    "proofs"
  ]
}

submit_proof

Relay the signed proof to the public completion gate: pass workId, the BODY_JSON from prepare_proof UNCHANGED, and the signature over MESSAGE_TO_SIGN. Approval follows (the creator, or self-verification where the packet supports it); funded packets settle the wage after approval, unfunded packets record provable credit. work_status shows where it stands.

Parameters3

workId	string	required	The packet id.
bodyJson	string	required	The exact BODY_JSON string from prepare_proof, unchanged.
signature	string	required	The 0x… personal_sign output over MESSAGE_TO_SIGN.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "The packet id."
    },
    "bodyJson": {
      "type": "string",
      "description": "The exact BODY_JSON string from prepare_proof, unchanged."
    },
    "signature": {
      "type": "string",
      "description": "The 0x… personal_sign output over MESSAGE_TO_SIGN."
    }
  },
  "required": [
    "workId",
    "bodyJson",
    "signature"
  ]
}

work_status

Live lifecycle state of one packet — OPEN, CLAIMED, PROOF_SUBMITTED, APPROVED, PROOF_REJECTED, SETTLED or EXPIRED — plus its honest pay status (funded vs proposed). Free, keyless, read-only.

Parameters1

workId

string

required

The packet id.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "The packet id."
    }
  },
  "required": [
    "workId"
  ]
}

funding_quote

For a BUYER, not a worker: ask whether one board packet can be funded right now, and what funding it costs. The price is the board's own posted wage — it is read from the board, never from anything you send, so no caller can fund a $700 packet for $1. Partial funding: when the host has chip-ins armed, any open packet also takes contributions from $0.01 up to what it still needs (contributeUsd on the funding POST), and paying above the wage is welcome — the extra is recorded as a premium reserved for the worker. A refusal comes back in the board's own words (already funded, claimed, settled, expired, no wage). Read-only: this quotes, it charges nothing and marks nothing funded. Call prepare_funding next to actually pay.

Parameters1

workId

string

required

The packet id, from find_work.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "The packet id, from find_work."
    }
  },
  "required": [
    "workId"
  ]
}

prepare_funding

Step 2 for a buyer: returns the live payment requirements for funding a packet — the onchain door's own x402 challenge (accepts[], exact amount, asset, chain, pay-to address) read from that door at this moment, and, when a card rail is mounted on this host, its hosted checkout URL. To chip in a slice instead of the whole wage, include contributeUsd in the funding POST the challenge names; omit it to pay everything the packet still needs. You pay from YOUR own wallet or card; this server holds no funds and no keys, takes no payment, and marks nothing funded. A packet becomes funded only when a payment actually settles and is verified.

Parameters2

workId	string	required	The packet id, from find_work.
funderWallet	string	optional	The 0x… address that will pay onchain. Needed for the onchain door's live challenge; the card path does not use it.

Raw schema

{
  "type": "object",
  "properties": {
    "workId": {
      "type": "string",
      "description": "The packet id, from find_work."
    },
    "funderWallet": {
      "type": "string",
      "description": "The 0x… address that will pay onchain. Needed for the onchain door's live challenge; the card path does not use it."
    }
  },
  "required": [
    "workId"
  ]
}

io.github.brawlaphant/vealth