Holder mandates
$PALISEC holders vote on an agent's limits, inside an envelope the owner sets. A passed vote becomes an ordinary policy version, and Palisec's co-signer enforces it.
How it works
- The owner sets an envelope: the highest per-transaction value and hourly budget, the lowest human-approval threshold, and the only contracts (and functions) a vote may ever allowlist. No vote can go past it.
- A holder proposes one typed change and signs it (gasless). The change must fit the envelope. Palisec takes a snapshot of every $PALISEC balance at the latest block.
- Holders vote for, against or abstain, each signing with their wallet (gasless). Weight is the balance at the snapshot block, so tokens bought after the proposal opens do not count.
- When voting closes, the count is final. A proposal passes when the votes cast reach the quorum and for is more than the pass share of for + against.
- A tightening applies at once. A loosening waits out the organization's loosening delay (60 minutes by default) with a visible countdown, and the owner or an operator can cancel it with a public reason.
The emergency stop still overrides everything. Votes change limits only; they never sign, approve or send anything.
What a vote can change
| Change | Bounded by |
|---|---|
set_max_transaction_value | envelope maximum |
set_hourly_budget | envelope maximum |
set_approval_threshold | envelope minimum |
allow_contract | only contracts and functions in the envelope |
remove_contract, add_deny | always allowed (they tighten) |
Removing a deny rule is never allowed by a vote. Each signed proposal is single-use.
The snapshot
Palisec rebuilds the full holder table at the snapshot block by replaying every $PALISEC Transfer log, then cross-checks it against balanceOf and totalSupply at that block. If anything differs or cannot be read, the proposal is not opened (PS_STATE_001): fail closed.
Recount any vote
Each proposal has a public vote file with every signature, every weight, the full holder table and the result. Anyone can recount it with a public RPC and without trusting Palisec: check each signature against the typed data below, rebuild the balances from Transfer logs up to the snapshot block, and apply the rules.
EIP-712 typed data
domain { name: "Palisec Mandates", version: "1", chainId: 4663 }
Proposal { string mandate; string title; string change; string nonce }
Vote { string mandate; string proposalId; uint8 choice; uint256 snapshotBlock }
// choice: 0 = for, 1 = against, 2 = abstainAPI
| Endpoint | Who |
|---|---|
POST /v1/mandates | owner or admin |
GET /v1/mandates, GET /v1/mandates/{id} | organization members |
POST /v1/mandates/{id}/envelope | owner |
POST /v1/mandates/{id}/proposals/{pid}/cancel | owner, admin or operator; reason required and shown publicly |
GET /v1/public/mandates/{slug} | anyone |
POST /v1/public/mandates/{slug}/proposals | a holder, with a signed proposal |
POST /v1/public/mandates/{slug}/proposals/{pid}/votes | a holder, with a signed vote |
GET /v1/public/mandates/{slug}/proposals/{pid}/vote-file | anyone |
Create a mandate
POST /api/v1/mandates (console session, owner or admin)
{
"slug": "my-agent",
"name": "My agent's limits",
"agent_id": "<agent id>",
"voting_period_seconds": 172800, // 60 s to 30 days; 24-72 h recommended
"quorum": "1000000000000000000000", // $PALISEC base units (18 decimals): 1,000
"pass_bps": 5000, // for must be more than 50% of for + against
"proposer_min": "1000000000000000000",
"envelope": {
"max_transaction_value_wei": "300000000000000",
"max_hourly_budget_usd_micros": "2000000",
"min_approval_threshold_usd_micros": "500000",
"allowed_contracts": [{ "address": "0x…", "selectors": ["0x04e45aaf"] }]
}
}Webhooks: mandate.proposal_created, mandate.vote_closed, mandate.applied and mandate.cancelled. In the console, the Mandates page shows the envelope, proposals and pending changes.
Live demo
palisec.tech/m/palisec-demo is a demo mandate on mainnet with 1-hour votes (real mandates should use 24 to 72 hours). It shows the envelope, the active limits, every proposal with its live count and vote file, any pending change with its countdown, and the agent's latest decisions.