API reference
Governance
Proposals and signed votes. A signal only: one wallet, one vote.
Note
Governance is an off-chain signal. One wallet, one vote until the token launches. Votes do not change the engine automatically.
GET /v1/proposals#
List proposals. Public.
GET /v1/proposals/:id#
One proposal with its votes. Public.
POST /v1/proposals#
Needs a bearer token. Limit: 2 per day per wallet.
Request·json
{ "title": "string", "body": "string" }POST /v1/proposals/:id/vote#
Needs a bearer token and a signature over this exact message:
Vote message·text
Forgeus vote
Proposal: <id>
Choice: <choice><choice> is for, against or abstain. Lines are joined with \n.
Request·json
{ "choice": "for | against | abstain", "signature": "0x…" }vote.ts·ts
const message = `Forgeus vote\nProposal: ${id}\nChoice: ${choice}`;
const signature = await wallet.signMessage({ account: address, message });
await fetch(`${API}/v1/proposals/${id}/vote`, {
method: "POST",
headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
body: JSON.stringify({ choice, signature }),
});Because each vote is signed, anyone can check that a vote came from the wallet that cast it.
Paper only. No funds are traded. $FOUS is not launched. Nothing here is financial advice.