Docs

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.