Realm

[0xNoushad]

Pull Request Description

Related Issue

Fixes #205

Changes Made

This PR adds comprehensive SPL Governance integration to the Solana Agent Kit, enabling programmatic DAO governance:

• Added Governance Tools:

  • Implemented complete SPL Governance program interactions in /src/tools/realm-governance/governance.ts
  • Created council management utilities in /src/tools/realm-governance/council.ts
  • Added real-time governance monitoring in /src/tools/realm-governance/monitor.ts

• Created Six New Governance Actions:

  • SPL_CREATE_REALM: Create new DAO realms with community/council configuration
  • SPL_CREATE_PROPOSAL: Create governance proposals with customizable voting options
  • SPL_CAST_VOTE: Cast votes on proposals with approve/deny/abstain choices
  • SPL_GET_REALM_INFO: Retrieve detailed realm configuration and status
  • SPL_GET_TOKEN_OWNER_RECORD: Get member voting power and participation records
  • SPL_GET_VOTER_HISTORY: Retrieve complete voting history for participants

Verification

https://explorer.solana.com/tx/5L3HFEKHyB6LMGVvpjArx971M6QL9cdNeeEaqR6nDL64CZaB485NzTZdKab2xUzycvMrjj3AfR5LuoJtYSypaisH?cluster=devnet

Prompt Used

• "Create a new DAO realm with specified configuration"
• "Create a new proposal in a DAO realm"
• "Cast a vote on a proposal"
• "Get information about a DAO realm"
• "Get token owner record for a member in a DAO realm"
• "Get voting history for a specific voter"

Checklist

• I have tested these changes locally
• I have updated the documentation
• I have added transaction links for verification
• I have added the prompts used to test the implementation

[michaelessiet]

Hi @0xNoushad , this PR doesn't follow the correct file structure and contents for action and tool files. Please reference other action and tool files in the project

[0xNoushad]

Will do everything in my final push !

[michaelessiet]

Will do everything in my final push !

Ok, please let me know once it's ready for review

[0xNoushad]

Will do everything in my final push !

Ok, please let me know once it's ready for review

Done !!

[michaelessiet]

Hi @0xNoushad please fix the error returned by the github action

[michaelessiet]

Please do not remove any actions/tools unrelated to your tools from exports. Consider renaming your tools instead

[michaelessiet]

Do not remove

[0xNoushad]

Check line 229

[michaelessiet]

Looks good! Only thing missing is the screenshots, please can you provide screenshots of the agent completing these prompts, as well as their transaction links

• "Create a new DAO realm with specified configuration"
• "Create a new proposal in a DAO realm"
• "Cast a vote on a proposal"
• "Get information about a DAO realm"
• "Get token owner record for a member in a DAO realm"
• "Get voting history for a specific voter"

[0xNoushad]

Looks good! Only thing missing is the screenshots, please can you provide screenshots of the agent completing these prompts, as well as their transaction links

• "Create a new DAO realm with specified configuration"

• "Create a new proposal in a DAO realm"

• "Cast a vote on a proposal"

• "Get information about a DAO realm"

• "Get token owner record for a member in a DAO realm"

• "Get voting history for a specific voter"

Check description!

[michaelessiet]

You did not provide the information the agent needed to carry out the actions