Council V1 - KasFun Docs

Contract Info

Property	Value
Address	Per-token (check token’s community page on kas.fun)
Network	Kasplex (see Addresses for chain details)

Each graduated token has its own Council contract address. The address is not global — query it from the token’s community page.

Election Functions

startElection

Start a council election. Requires platform EIP-712 signature.

function startElection(address token, bytes signature) external

voteElection

Vote for candidates. Tokens are locked until the election ends.

function voteElection(address token, ElectionVoteEntry[] votes) external

ElectionVoteEntry:

Field	Type	Description
`candidate`	address	Candidate address
`amount`	uint256	Token amount to allocate (wei)

claimElectionTokens

Claim locked tokens after election ends. First caller triggers finalization.

function claimElectionTokens(address token) external

Election Read Functions

getElectionState

function getElectionState(address token) external view returns (ElectionState)

Returns:

Field	Type	Description
`active`	bool	Election is running
`endTime`	uint256	End timestamp (unix seconds)
`lastElectionEnd`	uint256	Previous election end time
`finalized`	bool	Results have been finalized
`councilSize`	uint256	Number of seats
`epoch`	uint256	Election epoch counter

getCouncilMembers

function getCouncilMembers(address token) external view returns (address[])

isCouncilMember

function isCouncilMember(address token, address account) external view returns (bool)

getTop20Candidates

function getTop20Candidates(address token) external view returns (address[] candidates, uint256[] voteAmounts)

Returns candidates sorted by votes descending. Empty entries padded with address(0).

getCandidateVotes

function getCandidateVotes(address token, address candidate) external view returns (uint256)

Governance Functions

startGovernance

Start a governance round. Only callable by contract owner/manager.

function startGovernance(address token, uint256 proposalPhaseEnd, uint256 votingPhaseEnd) external

createProposal

Create a proposal. Requires platform EIP-712 signature.

function createProposal(
    address token,
    bytes32 nonce,
    bytes signature,
    uint256[] optionCodes,
    uint256 endTime,
    uint8 proposalType
) external

Parameter	Type	Description
`token`	address	Token address
`nonce`	bytes32	Unique nonce
`signature`	bytes	Platform signature
`optionCodes`	uint256[]	Option identifiers
`endTime`	uint256	Voting end timestamp
`proposalType`	uint8	0 = General, 1 = Tax

voteProposal

Vote on a proposal by locking tokens.

function voteProposal(address token, uint256 proposalId, VoteEntry[] votes) external

VoteEntry:

Field	Type	Description
`target`	address	`address(0)` for general proposals
`optionIndex`	uint8	Option index to vote for
`amount`	uint256	Token amount to allocate (wei)

finalizeProposal

Finalize a proposal after voting ends.

function finalizeProposal(address token, uint256 proposalId) external

claimProposalTokens

Claim locked tokens after proposal ends. First caller triggers finalization.

function claimProposalTokens(address token, uint256 proposalId) external

Governance Read Functions

getCouncilState

function getCouncilState(address token) external view returns (CouncilState)

Returns:

Field	Type	Description
`currentProposalId`	uint256	Latest proposal ID
`treasuryBalance`	uint256	Treasury balance (wei)
`governancePhase`	uint8	0 = Idle, 1 = Proposal, 2 = Voting
`proposalPhaseEnd`	uint256	Proposal phase end timestamp
`votingPhaseEnd`	uint256	Voting phase end timestamp
`roundFirstProposalId`	uint256	First proposal ID in current round

getProposal

function getProposal(address token, uint256 proposalId) external view returns (Proposal)

Returns:

Field	Type	Description
`startTime`	uint256	Start timestamp
`endTime`	uint256	End timestamp
`finalized`	bool	Whether finalized
`executed`	bool	Whether executed
`proposalType`	uint8	0 = General, 1 = Tax
`nonce`	bytes32	Unique nonce
`optionCount`	uint256	Number of options
`winningOption`	uint256	Winning option index
`optionCodes`	uint256[]	Option code identifiers

getProposalOptionVotes

function getProposalOptionVotes(address token, uint256 proposalId) external view returns (uint256[])

Returns vote counts per option (array index = option index).

getVoterOptionVotes

function getVoterOptionVotes(address token, uint256 proposalId, address voter) external view returns (uint256[])

Returns a voter’s allocated tokens per option.

getVoterLockedAmount

function getVoterLockedAmount(address token, uint256 proposalId, address voter) external view returns (uint256)

Returns total tokens locked by a voter in a proposal. Claimable after proposal ends.

Tax Functions

setTaxConfig

function setTaxConfig(address token, uint256 rate, uint8 purpose, address target) external

Only callable by owner/manager. Purpose: 0=None, 1=Burn, 2=Transfer, 3=CouncilTreasury.

getTaxConfig

function getTaxConfig(address token) external view returns (TaxConfig)

Returns:

Field	Type	Description
`rate`	uint256	Tax rate (basis points)
`purpose`	uint8	0=None, 1=Burn, 2=Transfer, 3=Treasury
`target`	address	Tax recipient address

isTaxExempt

function isTaxExempt(address token, address account) external view returns (bool)

Events

Election Events

event ElectionStarted(address indexed token, uint256 endTime, uint256 councilSize)
event ElectionVoted(address indexed token, address indexed voter, uint256 totalLocked, address[] candidates, uint256[] amounts)
event ElectionFinalized(address indexed token, address[] councilMembers)
event ElectionTokensClaimed(address indexed token, address indexed voter, uint256 amount)

Proposal Events

event ProposalCreated(address indexed token, uint256 indexed proposalId, bytes32 indexed nonce, address proposer, uint8 proposalType, uint256[] optionCodes, uint256 endTime)
event ProposalFinalized(address indexed token, uint256 indexed proposalId, uint256 winningOption, uint256 winningVotes)

Full ABI (JSON)

Council V1 ABI JSON

[
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "councilSize", "type": "uint256"}, {"internalType": "uint256", "name": "minInterval", "type": "uint256"}, {"internalType": "uint256", "name": "duration", "type": "uint256"}], "name": "initElectionConfig", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "bytes", "name": "signature", "type": "bytes"}], "name": "startElection", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"components": [{"internalType": "address", "name": "candidate", "type": "address"}, {"internalType": "uint256", "name": "amount", "type": "uint256"}], "internalType": "struct ICouncil.ElectionVoteEntry[]", "name": "votes", "type": "tuple[]"}], "name": "voteElection", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}], "name": "claimElectionTokens", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalPhaseEnd", "type": "uint256"}, {"internalType": "uint256", "name": "votingPhaseEnd", "type": "uint256"}], "name": "startGovernance", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "bytes32", "name": "nonce", "type": "bytes32"}, {"internalType": "bytes", "name": "signature", "type": "bytes"}, {"internalType": "uint256[]", "name": "optionCodes", "type": "uint256[]"}, {"internalType": "uint256", "name": "endTime", "type": "uint256"}, {"internalType": "uint8", "name": "proposalType", "type": "uint8"}], "name": "createProposal", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}, {"components": [{"internalType": "address", "name": "target", "type": "address"}, {"internalType": "uint8", "name": "optionIndex", "type": "uint8"}, {"internalType": "uint256", "name": "amount", "type": "uint256"}], "internalType": "struct ICouncil.VoteEntry[]", "name": "votes", "type": "tuple[]"}], "name": "voteProposal", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}], "name": "finalizeProposal", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}], "name": "claimProposalTokens", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "rate", "type": "uint256"}, {"internalType": "uint8", "name": "purpose", "type": "uint8"}, {"internalType": "address", "name": "target", "type": "address"}], "name": "setTaxConfig", "outputs": [], "stateMutability": "nonpayable", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}], "name": "getElectionState", "outputs": [{"components": [{"internalType": "bool", "name": "active", "type": "bool"}, {"internalType": "uint256", "name": "endTime", "type": "uint256"}, {"internalType": "uint256", "name": "lastElectionEnd", "type": "uint256"}, {"internalType": "bool", "name": "finalized", "type": "bool"}, {"internalType": "uint256", "name": "councilSize", "type": "uint256"}, {"internalType": "uint256", "name": "epoch", "type": "uint256"}], "internalType": "struct ICouncil.ElectionState", "name": "", "type": "tuple"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}], "name": "getCouncilMembers", "outputs": [{"internalType": "address[]", "name": "", "type": "address[]"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "address", "name": "account", "type": "address"}], "name": "isCouncilMember", "outputs": [{"internalType": "bool", "name": "", "type": "bool"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}], "name": "getTop20Candidates", "outputs": [{"internalType": "address[]", "name": "candidates", "type": "address[]"}, {"internalType": "uint256[]", "name": "voteAmounts", "type": "uint256[]"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "address", "name": "candidate", "type": "address"}], "name": "getCandidateVotes", "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}], "name": "getCouncilState", "outputs": [{"components": [{"internalType": "uint256", "name": "currentProposalId", "type": "uint256"}, {"internalType": "uint256", "name": "treasuryBalance", "type": "uint256"}, {"internalType": "uint8", "name": "governancePhase", "type": "uint8"}, {"internalType": "uint256", "name": "proposalPhaseEnd", "type": "uint256"}, {"internalType": "uint256", "name": "votingPhaseEnd", "type": "uint256"}, {"internalType": "uint256", "name": "roundFirstProposalId", "type": "uint256"}], "internalType": "struct ICouncil.CouncilState", "name": "", "type": "tuple"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}], "name": "getProposal", "outputs": [{"components": [{"internalType": "uint256", "name": "startTime", "type": "uint256"}, {"internalType": "uint256", "name": "endTime", "type": "uint256"}, {"internalType": "bool", "name": "finalized", "type": "bool"}, {"internalType": "bool", "name": "executed", "type": "bool"}, {"internalType": "uint8", "name": "proposalType", "type": "uint8"}, {"internalType": "bytes32", "name": "nonce", "type": "bytes32"}, {"internalType": "uint256", "name": "optionCount", "type": "uint256"}, {"internalType": "uint256", "name": "winningOption", "type": "uint256"}, {"internalType": "uint256[]", "name": "optionCodes", "type": "uint256[]"}], "internalType": "struct ICouncil.Proposal", "name": "", "type": "tuple"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}], "name": "getProposalOptionVotes", "outputs": [{"internalType": "uint256[]", "name": "", "type": "uint256[]"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}, {"internalType": "address", "name": "voter", "type": "address"}], "name": "getVoterOptionVotes", "outputs": [{"internalType": "uint256[]", "name": "", "type": "uint256[]"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "uint256", "name": "proposalId", "type": "uint256"}, {"internalType": "address", "name": "voter", "type": "address"}], "name": "getVoterLockedAmount", "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}], "name": "getTaxConfig", "outputs": [{"components": [{"internalType": "uint256", "name": "rate", "type": "uint256"}, {"internalType": "uint8", "name": "purpose", "type": "uint8"}, {"internalType": "address", "name": "target", "type": "address"}], "internalType": "struct ICouncil.TaxConfig", "name": "", "type": "tuple"}], "stateMutability": "view", "type": "function"},
  {"inputs": [{"internalType": "address", "name": "token", "type": "address"}, {"internalType": "address", "name": "account", "type": "address"}], "name": "isTaxExempt", "outputs": [{"internalType": "bool", "name": "", "type": "bool"}], "stateMutability": "view", "type": "function"},
  {"anonymous": false, "inputs": [{"indexed": true, "internalType": "address", "name": "token", "type": "address"}, {"indexed": false, "internalType": "uint256", "name": "endTime", "type": "uint256"}, {"indexed": false, "internalType": "uint256", "name": "councilSize", "type": "uint256"}], "name": "ElectionStarted", "type": "event"},
  {"anonymous": false, "inputs": [{"indexed": true, "internalType": "address", "name": "token", "type": "address"}, {"indexed": false, "internalType": "address[]", "name": "councilMembers", "type": "address[]"}], "name": "ElectionFinalized", "type": "event"},
  {"anonymous": false, "inputs": [{"indexed": true, "internalType": "address", "name": "token", "type": "address"}, {"indexed": true, "internalType": "address", "name": "voter", "type": "address"}, {"indexed": false, "internalType": "uint256", "name": "totalLocked", "type": "uint256"}, {"indexed": false, "internalType": "address[]", "name": "candidates", "type": "address[]"}, {"indexed": false, "internalType": "uint256[]", "name": "amounts", "type": "uint256[]"}], "name": "ElectionVoted", "type": "event"},
  {"anonymous": false, "inputs": [{"indexed": true, "internalType": "address", "name": "token", "type": "address"}, {"indexed": true, "internalType": "address", "name": "voter", "type": "address"}, {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"}], "name": "ElectionTokensClaimed", "type": "event"},
  {"anonymous": false, "inputs": [{"indexed": true, "internalType": "address", "name": "token", "type": "address"}, {"indexed": true, "internalType": "uint256", "name": "proposalId", "type": "uint256"}, {"indexed": true, "internalType": "bytes32", "name": "nonce", "type": "bytes32"}, {"indexed": false, "internalType": "address", "name": "proposer", "type": "address"}, {"indexed": false, "internalType": "uint8", "name": "proposalType", "type": "uint8"}, {"indexed": false, "internalType": "uint256[]", "name": "optionCodes", "type": "uint256[]"}, {"indexed": false, "internalType": "uint256", "name": "endTime", "type": "uint256"}], "name": "ProposalCreated", "type": "event"},
  {"anonymous": false, "inputs": [{"indexed": true, "internalType": "address", "name": "token", "type": "address"}, {"indexed": true, "internalType": "uint256", "name": "proposalId", "type": "uint256"}, {"indexed": false, "internalType": "uint256", "name": "winningOption", "type": "uint256"}, {"indexed": false, "internalType": "uint256", "name": "winningVotes", "type": "uint256"}], "name": "ProposalFinalized", "type": "event"}
]

​Contract Info

​Election Functions

​startElection

​voteElection

​claimElectionTokens

​Election Read Functions

​getElectionState

​getCouncilMembers

​isCouncilMember

​getTop20Candidates

​getCandidateVotes

​Governance Functions

​startGovernance

​createProposal

​voteProposal

​finalizeProposal

​claimProposalTokens

​Governance Read Functions

​getCouncilState

​getProposal

​getProposalOptionVotes

​getVoterOptionVotes

​getVoterLockedAmount

​Tax Functions

​setTaxConfig

​getTaxConfig

​isTaxExempt

​Events

​Election Events

​Proposal Events

​Full ABI (JSON)

Contract Info

Election Functions

startElection

voteElection

claimElectionTokens

Election Read Functions

getElectionState

getCouncilMembers

isCouncilMember

getTop20Candidates

getCandidateVotes

Governance Functions

startGovernance

createProposal

voteProposal

finalizeProposal

claimProposalTokens

Governance Read Functions

getCouncilState

getProposal

getProposalOptionVotes

getVoterOptionVotes

getVoterLockedAmount

Tax Functions

setTaxConfig

getTaxConfig

isTaxExempt

Events

Election Events

Proposal Events

Full ABI (JSON)